在 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。
? 小技巧:为简化调试,可在脚本末尾添加类型检查和显式转换: