await 是协调原生桥接与 Web/JS 层执行节奏的关键节拍器，需区分必须等待与可并发操作，通过确认异步边界、按状态而非时间等待、合并批处理请求及设置 Promise.race 超时来精准控制步长。
在跨端混合应用的 UI 自动化测试中，await 不是“等完再走”的万能胶布，而是协调原生桥接（Native Bridge）与 Web/JS 层执行节奏的关键节拍器。精准控制步长，核心在于区分「必须等待」和「可以并发」的操作，避免因过度 await 导致桥接调用被阻塞、UI 状态不同步或超时失败。
明确桥接调用的异步边界
原生桥接（如 Flutter 的 MethodChannel、uni-app 的 nativePlugin、KIVI 的 JS API 桥）本质上是跨线程/跨进程通信，返回的是 Promise。但并非所有桥接方法都真正异步——有些只是同步封装后返回 Promise，有些则涉及耗时 IO 或主线程调度。
- 查看框架文档确认方法是否标记为
async或注明“returns a Promise”； - 对不确定的方法，用
console.time或平台日志（如 Android Logcat 中的 channel 调用时间戳）实测真实耗时； - 例如：Flutter 中
invokeMethod('getDeviceInfo')通常毫秒级完成，而invokeMethod('uploadFile')则需 await； - 避免对已知同步桥接（如部分 KIVI 的
app.showNotification()）无谓 await，它不会提升稳定性，只会拖慢执行。
拆分桥接任务，按状态而非时间 await
不要用 await delay(1000) 等待原生操作“看起来完成了”，而应监听可验证的状态变化：
- 等待 WebView 加载完成 →
await page.waitForLoadState('networkidle')（Playwright）或await driver.waitUntil(() => document.readyState === 'complete')（WebdriverIO）； - 等待原生弹窗出现 → 使用 UI 自动化控件模式（如 Windows UI Automation 的
WindowPattern）或平台专属 API（如 Appium 的mobile: isAppInstalled）主动查询； - 等待桥接触发的本地文件写入 → 在桥接回调中返回临时 token，并在 JS 层轮询
fs.existsSync('/path/to/file')（Node.js 环境）或调用另一桥接方法checkFileReady(token)。
合并与批处理桥接请求
频繁细粒度 await 桥接调用会放大序列化开销（尤其在 Flutter MethodChannel 或 uni-automator 的 WebSocket 通道中），应主动聚合：
- 将多个配置读取合并为一次桥接：
await bridge.invoke('getConfigBatch', ['theme', 'lang', 'token'])； - 在 Midscene.js 或支持视觉反馈的框架中，用单次
aiAct('设置夜间模式并重启应用')替代多次 await 原生开关 + await 重启监听； - 对 uni-app 的
nativePlugin，优先使用其提供的批量接口（如setStorageMultiple），而非循环 await 单个setStorage。
用 Promise.race 控制桥接步长上限
原生桥接可能因设备卡顿、权限未授、后台限制等原因无限期挂起。必须为每个关键桥接设置明确的超时边界：
const result = await Promise.race([bridge.invoke('fetchUserData'), new Promise((_, r) => setTimeout(r, 5000, 'timeout'))]);- 在 Playwright 中结合
page.waitForFunction和桥接结果：await page.waitForFunction((expected) => window.bridgeResult === expected, { timeout: 3000 }, 'success'); - 对 Flutter 测试，利用
tester.runAsync+expectLater配合超时断言，比裸 await 更可控。
