在 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。
? 小技巧：为简化调试，可在脚本末尾添加类型检查和显式转换：
立即学习“Java免费学习笔记（深入）”；
await (async () => {
const val = await myAsyncJsFunction();
// 确保返回可序列化值（避免函数、undefined、Symbol 等）
return val == null ? null : JSON.parse(JSON.stringify(val));
})();总结：WebView2 的 ExecuteScriptAsync 不具备自动 Promise 解包能力。“async” 必须配 “await”，且 await 必须作用于最终返回值所在的 Promise 表达式层级——这是跨语言异步桥接的关键契约。
