async/await 是让异步代码写起来像同步的语法糖,在自动化测试中配合浏览器api的promise自然实现动作完成等待;它等待的是返回promise的操作方法(如click、waitforselector),而非阻塞式延时,需在async函数中使用并避免遗漏await导致flaky测试。

async/await 本身不是用来“同步等待”的工具,而是让异步代码写起来像同步——在自动化测试(如用 Puppeteer、Playwright 或 Selenium WebDriver)中,它配合浏览器 API 的 Promise 返回值,自然实现“等待动作完成后再执行下一步”,无需手动轮询或 sleep。
理解 await 等待的是什么
关键点:await 等待的是一个 返回 Promise 的浏览器操作方法,比如点击、输入、导航、等待元素出现等。这些方法内部已封装好异步逻辑(如等待渲染、事件触发、网络响应),你只需 await 它们即可。
- Puppeteer 中
page.click(selector)返回 Promise,await 它就等点击完成(含事件冒泡、页面响应) - Playwright 中
page.waitForSelector('.loaded')返回 Promise,await 它就等元素出现 - 不要 await
setTimeout或空延时——那是阻塞式假等待,不可靠也不推荐
典型测试步骤中的正确 await 写法
以登录流程为例(Puppeteer):
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
-
await page.goto('https://example.com/login');—— 等页面加载完成(含 DOM + load 事件) -
await page.fill('#username', 'test');—— 等输入框聚焦、内容填入、input/change 事件触发 -
await page.click('button[type="submit"]');—— 等点击执行、事件处理、可能的导航或状态更新 -
await page.waitForNavigation();—— 显式等待后续导航完成(如跳转到首页) -
await expect(page).toHaveURL(/dashboard/);—— Playwright 中断言也基于 Promise,自动重试等待条件满足
避免常见陷阱
看似“同步”,但逻辑仍异步,需注意上下文和错误处理:
- 不要在非 async 函数里用 await —— 会报语法错误;测试用例函数必须声明为
async - 不加 await 会导致动作“发射即忘”,后续断言可能执行过早,造成 flaky 测试
- 超时控制很重要:Puppeteer 默认 30s 超时,Playwright 默认 5s,可通过
{ timeout: 10000 }显式设置 - 避免混合使用回调式等待(如
page.on('response', ...))和 await —— 容易丢失时序或漏 await
进阶:封装可复用的 awaitable 行为
把常用操作包装成返回 Promise 的函数,提升可读性和稳定性:
async function login(page, user) { await page.fill('#user', user); await page.click('#login-btn'); await page.waitForSelector('#welcome'); }- 配合自定义等待器,如
await page.waitForFunction(() => window.appReady === true);等待前端状态就绪 - 用
Promise.race()实现带兜底的等待,例如“等元素出现或 5 秒后失败”
本质上,async/await 在测试脚本中不是强行“同步化”,而是顺应浏览器自动化工具的设计范式——每个动作天然异步且可等待,你只需用 await 告诉 JS:“这里停一下,等它干完再往下走”。写对了,测试既稳定又易读。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










