自动化测试 / 系统课时
替代固定时间等待
替代固定时间等待
固定等待把“也许已经完成”误当成“时间到了就一定完成”。这一课用元素状态、网络响应和 Web 断言替代固定延时,让测试只等待真正需要的条件,并在条件不成立时给出明确失败。
学习目标
- 识别
page.waitForTimeout()导致慢测和偶发失败的原因 - 根据页面状态、网络响应或导航结果选择合适的等待信号
- 用自动重试断言把“等待完成”和“验证结果”合并为一步
固定时间为什么不可靠
page.waitForTimeout(1000) 只保证暂停 1 秒,并不保证业务已经完成。机器变慢、网络抖动或后端排队超过 1 秒时,测试仍会继续并失败;如果实际只需 100 毫秒,又会白白浪费 900 毫秒。
选择替代方案时,先问“下一步为什么可以安全执行”:按钮变为可用、提示文字出现属于元素状态;保存接口返回属于网络信号;页面跳转属于 URL 或导航信号。

让断言负责等待页面状态
Locator 操作会在执行前等待相关可操作条件,Playwright 的 Web 断言则会持续重试,直到条件满足或超时。因此,提交后要确认“已保存”出现时,直接断言最终状态通常比先等待再读取文本更稳。
如果只是等待某个元素进入状态而不需要断言,可以使用 locator.waitFor();如果本来就需要验证结果,优先使用 expect(locator),避免重复写一段等待逻辑。
同时等待触发的网络响应
当后续动作依赖某个接口确实完成时,应在触发操作之前先注册响应等待,再执行点击。下面的测试用路由构造一个自包含页面,点击“保存”后发起 POST 请求,并同时验证 HTTP 响应和页面状态。
import { test, expect } from '@playwright/test';
test('用真实信号等待保存完成', async ({ page }) => {
await page.route('https://app.test/**', async route => {
if (route.request().url().endsWith('/api/save')) {
await route.fulfill({
status: 200,
contentType: 'application/json',
body: JSON.stringify({ ok: true }),
});
return;
}
await route.fulfill({
contentType: 'text/html',
body: `
<button id="save">保存</button>
<span data-testid="status">待保存</span>
<script>
document.querySelector('#save').addEventListener('click', async () => {
const response = await fetch('/api/save', { method: 'POST' });
if (response.ok) {
document.querySelector('[data-testid="status"]').textContent = '已保存';
}
});
</script>
`,
});
});
await page.goto('https://app.test/');
// 先开始监听,避免响应过快而错过事件。
const responsePromise = page.waitForResponse(
response => response.url().endsWith('/api/save') && response.status() === 200,
);
await page.getByRole('button', { name: '保存' }).click();
const response = await responsePromise;
// 断言会自动重试,直到页面真正显示完成状态。
await expect(page.getByTestId('status')).toHaveText('已保存');
console.log(`状态: ${await page.getByTestId('status').textContent()}, HTTP: ${response.status()}`);
});运行测试:
npx playwright test waits.spec.ts --reporter=line预期输出的关键部分如下,<TIME> 会随机器性能变化:
状态: 已保存, HTTP: 200
1 passed (<TIME>)按业务完成条件选择等待方式
普通点击前不必人为加延时,先依赖 Locator 的自动等待。页面最终状态可被用户观察到时,用 toBeVisible()、toHaveText()、toBeEnabled() 等 Web 断言;必须确认特定接口完成时,用 waitForResponse();发生跳转时,用 URL 断言验证目标地址。
关键不是把 1 秒改成 3 秒,而是把“等待时间”改成“等待事实”。这样快环境不会被多余延时拖慢,慢环境也能在真正超时前持续等待,并把失败定位到具体条件。