本文详解如何在 ios 的 wkwebview 中通过 evaluatejavascript(_:completionhandler:) 调用 javascript 函数、读取全局对象属性，并安全处理异步返回结果，涵盖错误处理、类型校验与典型实战场景（如获取用户 id、上传推送 token）。
本文详解如何在 ios 的 wkwebview 中通过 evaluatejavascript(_:completionhandler:) 调用 javascript 函数、读取全局对象属性，并安全处理异步返回结果，涵盖错误处理、类型校验与典型实战场景（如获取用户 id、上传推送 token）。
在基于 WKWebView 的混合开发中，原生代码与网页 JavaScript 的双向通信是常见需求。例如：从 JS 环境中读取用户身份标识（如 GameState.Profile.Uid()）、调用 JS 方法上传设备推送 Token 至服务端等。核心能力依赖于 WKWebView.evaluateJavaScript(_:completionHandler:) —— 它以异步方式执行脚本并回调结果。
✅ 正确调用方式与最佳实践
以下是一个健壮的封装示例，用于安全获取用户 ID：
func getProfileUserIDFromJavaScript() {
let javascript = "typeof GameState !== 'undefined' && typeof GameState.Profile !== 'undefined' && typeof GameState.Profile.Uid === 'function' ? GameState.Profile.Uid() : null"
webView.evaluateJavaScript(javascript) { [weak self] (result, error) in
guard let self = self else { return }
if let error = error {
print("JS 执行失败: \(error.localizedDescription)")
return
}
// 显式类型检查，避免运行时崩溃
if let userID = result as? String, !userID.isEmpty {
self.userID = userID
print("✅ 成功获取 User ID: \(userID)")
} else if result is NSNull || result == nil {
print("⚠️ JS 函数返回 null 或未定义")
} else {
print("❌ 返回值类型不匹配，期望 String，实际为: \(type(of: result))")
}
}
}? 关键点说明：
- 使用 typeof 链式判断确保 GameState.Profile.Uid 是可调用函数，避免 ReferenceError；
- 主动校验 result 是否为 String 且非空，而非直接强制解包；
- 使用 [weak self] 防止循环引用；
- 区分 nil（无返回）、NSNull（JS 中的 null）与无效类型，提升容错性。
? 调用 JS 函数上传 Push Token
类似地，若需将 APNs Token 传给网页侧 JS 处理（如注册至推送网关），可构造带参数的调用：
立即学习“Java免费学习笔记（深入）”；
func uploadPushToken(_ token: Data) {
let tokenString = token.map { String(format: "%02x", $0) }.joined()
let javascript = "window.setPushToken && typeof window.setPushToken === 'function' ? window.setPushToken('\(tokenString)') : console.warn('setPushToken 未定义')"
webView.evaluateJavaScript(javascript) { (result, error) in
if let error = error {
print("上传 Token 失败: \(error.localizedDescription)")
} else {
print("? Push Token 已提交至 JS 层")
}
}
}⚠️ 注意事项与避坑指南
- 线程安全：evaluateJavaScript 必须在主线程调用，否则可能触发未定义行为；
- JS 上下文就绪：确保 WebView 已完成加载（监听 webView(_: didFinish:)），且目标 JS 已注入完毕；
- 字符串转义：向 JS 传递动态字符串（如 Token、JSON）时，务必使用 JSONSerialization 或 stringByAddingPercentEncoding 避免语法错误；
- 超时控制：系统未提供超时参数，如需强约束，建议结合 DispatchWorkItem + cancel() 实现手动超时；
- 调试技巧：可在 JS 中临时添加 console.log()，并通过 WKWebView.configuration.preferences.javaScriptLoggingEnabled = true 启用日志捕获。
掌握 evaluateJavaScript 的正确用法，不仅能高效桥接原生与 Web 功能，更是构建稳定混合应用的关键基础。始终以防御性编程思维处理 JS 返回值，并将类型校验、上下文验证、错误分类作为标准流程，即可显著降低线上异常率。
