WebView2 中正确调用异步 JavaScript 函数并获取返回值的方法-js教程

在 webview2 中使用 `executescriptasync` 调用 async javascript 函数时,必须显式 `await` 整个立即执行异步函数(iife),否则脚本会立即返回未完成的 promise 对象,导致 c# 端收到空对象 `{}` 或 `”null”`。

ExecuteScriptAsync 的设计本质是同步执行 JavaScript 表达式并等待其求值结果——但它不会自动等待 Promise 的 resolve。当你传入一个 async () => { … } 函数却不 await 它时,JavaScript 引擎仅返回一个处于 pending 状态的 Promise 实例;而 WebView2 在序列化该 Promise 为 JSON 时,因 Promise 不可直接序列化,最终返回空对象 {}(早期版本)或 “null”(较新版本),而非你期望的 resolved 值。

✅ 正确做法:在 JavaScript 字符串中,对整个 async IIFE 显式使用 await,确保 ExecuteScriptAsync 等待 Promise 完成后再返回结果:

// ✅ 正确:await 整个 async IIFE,返回 resolved 值(如 true、{ data: "ok" } 等)
var result = await webView.CoreWebView.ExecuteScriptAsync(
    "await (async () => { " +
    "  const bar = await myAsyncJsFunction(); " +
    "  return bar; " +
    "})();"
);

// 示例:返回布尔值 → 结果为字符串 "true"
// 示例:返回对象 → 结果为 JSON 字符串 "{\"message\":\"success\"}"

⚠️ 注意事项:

  • ExecuteScriptAsync 总是返回 string 类型(JSON 序列化后的结果),不是原始 JS 类型。即使 JS 返回 true,C# 收到的是字符串 “true”;返回 { foo: 123 },收到的是 “{“foo”:123}”。需手动 JsonSerializer.Deserialize(result) 解析。
  • 若 JS 抛出异常(如 myAsyncJsFunction() 拒绝 Promise),ExecuteScriptAsync 将抛出 WebException(含错误消息),需 try/catch 处理。
  • 避免遗漏分号或括号——JS 字符串需语法完全合法。推荐使用逐行拼接 + 注释方式提升可维护性(如上例)。
  • 不要写成 (async () => { … })().then(…):.then() 是异步链,ExecuteScriptAsync 不会等待它,仍会立即返回 undefined。

? 小技巧:为简化调试,可在脚本末尾添加类型检查和显式转换:

夏夕资源网专注于CMS网站模板,主流语言整站网站源码下载,网站建设相关教程分享,好用的软件素材整合下载,提供一站式便捷自助服务。
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,默认解压密码为"zy.lucklyus.top",如遇到无法解压的请联系管理员!
夏夕资源网-网站模板_免费源码_资源素材 » WebView2 中正确调用异步 JavaScript 函数并获取返回值的方法-js教程
在线时间:12:00 - 22:00
关注微信公众号:微信公众号
站长邮箱:[email protected]
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4013645+
  • 本周更新: 0+
  • 最后更新: 2026-03-16

本站指数

×
  • 运营天数: 1393+
  • 资源总数: 47989+
  • 用户总数: 1+
  • 今日更新: 0+
  • 访问次数: 4013645+
  • 本周更新: 0+
  • 最后更新: 2026-03-16