自动化测试 / 系统课时

替代固定时间等待

替代固定时间等待

固定等待把“也许已经完成”误当成“时间到了就一定完成”。这一课用元素状态、网络响应和 Web 断言替代固定延时,让测试只等待真正需要的条件,并在条件不成立时给出明确失败。

学习目标

  • 识别 page.waitForTimeout() 导致慢测和偶发失败的原因
  • 根据页面状态、网络响应或导航结果选择合适的等待信号
  • 用自动重试断言把“等待完成”和“验证结果”合并为一步

固定时间为什么不可靠

page.waitForTimeout(1000) 只保证暂停 1 秒,并不保证业务已经完成。机器变慢、网络抖动或后端排队超过 1 秒时,测试仍会继续并失败;如果实际只需 100 毫秒,又会白白浪费 900 毫秒。

选择替代方案时,先问“下一步为什么可以安全执行”:按钮变为可用、提示文字出现属于元素状态;保存接口返回属于网络信号;页面跳转属于 URL 或导航信号。

从固定延时切换到真实等待信号的选择流程

让断言负责等待页面状态

Locator 操作会在执行前等待相关可操作条件,Playwright 的 Web 断言则会持续重试,直到条件满足或超时。因此,提交后要确认“已保存”出现时,直接断言最终状态通常比先等待再读取文本更稳。

如果只是等待某个元素进入状态而不需要断言,可以使用 locator.waitFor();如果本来就需要验证结果,优先使用 expect(locator),避免重复写一段等待逻辑。

同时等待触发的网络响应

当后续动作依赖某个接口确实完成时,应在触发操作之前先注册响应等待,再执行点击。下面的测试用路由构造一个自包含页面,点击“保存”后发起 POST 请求,并同时验证 HTTP 响应和页面状态。

ts
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()}`);
});

运行测试:

bash
npx playwright test waits.spec.ts --reporter=line

预期输出的关键部分如下,<TIME> 会随机器性能变化:

text
状态: 已保存, HTTP: 200
1 passed (<TIME>)

按业务完成条件选择等待方式

普通点击前不必人为加延时,先依赖 Locator 的自动等待。页面最终状态可被用户观察到时,用 toBeVisible()、toHaveText()、toBeEnabled() 等 Web 断言;必须确认特定接口完成时,用 waitForResponse();发生跳转时,用 URL 断言验证目标地址。

关键不是把 1 秒改成 3 秒,而是把“等待时间”改成“等待事实”。这样快环境不会被多余延时拖慢,慢环境也能在真正超时前持续等待,并把失败定位到具体条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

替代固定时间等待

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通