await 是精准同步 hybrid 应用原生桥接生命周期的关键手段，必须配合桥接就绪信号、平台渲染状态和 webview 初始化约束使用，而非简单等待页面加载或硬编码延时。
在自动化 UI 测试中，await 不是简单“等一下”，而是精准同步 Hybrid 应用原生桥接（JSBridge / WebView 通信）生命周期的关键手段。它必须配合桥接协议的完成信号、平台渲染状态和 WebView 初始化约束来使用，否则容易出现“看似执行了，实则没生效”的假成功。
明确 await 的作用边界：它等的是“桥接就绪”，不是“页面加载完”
Hybrid 应用中，WebView 内容可能已渲染，但 JSBridge 尚未注册完成；或原生模块已就绪，但 JS 端回调函数未挂载。盲目 await page.waitForSelector 或 await driver.sleep(2000) 无法保证桥接通道可用。
- 优先监听桥接初始化完成事件，例如：
await driver.evaluate(() => window.JSBridge?.ready === true) - 对 .NET MAUI Blazor Hybrid，需等待
WebViewManager.IsInitialized返回 true，再调用 JS 方法 - 在 iOS Catalyst 或 WinUI3 中，需确认
WebView2.CoreWebView2.WebMessageReceived已订阅，再触发 JS 调用
桥接调用链中每个环节都需独立 await，不可合并或省略
一次典型桥接调用包含：JS 发起 → 原生拦截解析 → 执行逻辑 → 返回结果 → JS 回调触发。任一环节异步性未被 await 捕获，都会导致后续断言失败或状态错乱。
- 调用原生能力时，必须
await driver.evaluate(() => JSBridge.callNative('camera', {}))，而非仅driver.evaluate(...) - 若桥接返回 Promise（如 Playwright + UIA 场景），需确保原生层 resolve 后才进入下一步：
const result = await driver.evaluate(() => new Promise(resolve => JSBridge.on('camera:done', resolve))) - Blazor Hybrid 中调用
JSRuntime.InvokeVoidAsync后，需await其返回 Task，并验证DotNetObjectReference是否已绑定到 JS 全局对象
跨平台差异下，await 的等待目标必须动态适配
Android WebView、iOS WKWebView、WinUI3 WebView2 对桥接消息的投递时机和线程模型不同，统一写法极易失效。
- iOS 上需
await driver.evaluate(() => window.webkit.messageHandlers.JSBridge.postMessage(...))，且必须等WKScriptMessageHandler的didReceive完成后才可断言 - Android 需识别是否启用
addJavascriptInterface或evaluateJavascript，前者无返回值，后者需awaitevaluate 结果字符串解析 - WinUI3 中，
CoreWebView2.PostWebMessageAsString是同步投递但异步送达，应await对应的WebMessageReceived事件监听器触发
结合测试框架智能等待机制，避免硬编码 timeout
单纯靠 await new Promise(r => setTimeout(r, 1000)) 属于反模式。应利用框架原生支持的条件等待能力，让 await 等待可验证的状态变化。
- Maestro 中用
waitForElement+ 自定义 predicate：waitForElement("jsbridge-ready", { predicate: "window.JSBridge && window.JSBridge.isReady()" }) - Hypium 中用
driver.waitForExist检查全局桥接对象属性：await driver.waitForExist(() => typeof window.JSBridge !== 'undefined' && window.JSBridge.version) - Playwright 中用
page.waitForFunction监听桥接回调注册完成：await page.waitForFunction(() => typeof window.bridgeCallback === 'function')
