自动化测试 / 系统课时

配置测试超时

配置测试超时

自动化测试需要在“给正常页面足够时间”和“尽快暴露卡死”之间取平衡。本课会把 Playwright 的测试级、断言级和操作级超时拆开配置,并用一个可运行示例验证覆盖关系,最后说明为什么固定等待通常不是正确的稳定性方案。

学习目标

  • 区分测试超时、断言超时、操作超时和导航超时的职责
  • 使用配置文件、test.setTimeout() 和单次操作参数设置不同层级的上限
  • 用自动等待和条件断言替代无意义的固定等待

先区分各层超时

Playwright Test 默认给每个测试 30 秒测试超时;自动重试断言默认有 5 秒断言超时。actionTimeout 和 navigationTimeout 默认都是 0,表示没有额外的操作级或导航级上限,但这些动作仍处在测试本身的总时间预算内。

层级 常用配置 解决的问题
单个测试的默认上限 timeout 防止整条用例长期不结束
自动重试断言 expect.timeout 等待页面最终达到预期状态
点击、填写等动作 use.actionTimeout 限制单个动作等待可操作状态的时间
导航动作 use.navigationTimeout 限制 goto 等导航等待时间
当前测试覆盖 test.setTimeout() 只放宽或收紧一个特殊用例
当前动作覆盖 { timeout: ... } 只调整一次点击、导航或断言

配置默认超时

把团队的常规预算放在 playwright.config.ts,让大部分测试共享同一规则。下面的数值是示例,不应机械套用;应根据应用正常响应时间和 CI 环境调整。

ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  timeout: 30_000,
  expect: {
    timeout: 5_000,
  },
  use: {
    // 给单个动作设置上限,避免元素长期不可操作时一直拖延。
    actionTimeout: 10_000,
    navigationTimeout: 15_000,
  },
});

生效行为:普通测试最多使用 30 秒;Web-First 断言最多等待 5 秒;点击、填写等动作最多等待 10 秒,导航最多等待 15 秒。某个更具体的超时参数会覆盖对应的默认值。

为单用例和单操作覆盖

特殊慢用例不应迫使整个项目都提高超时。下面的测试把当前用例收紧为 10 秒,同时给点击和断言各自设置 2 秒上限。页面状态在点击后约 300 毫秒更新,因此无需人工休眠。

ts
import { test, expect } from '@playwright/test';

test('保存后显示成功状态', async ({ page }) => {
  test.setTimeout(10_000);

  // 用内联页面消除网络依赖,只验证等待与超时行为。
  await page.setContent(`
    <button id="save">保存</button>
    <p id="status"></p>
    <script>
      document.querySelector('#save').addEventListener('click', () => {
        setTimeout(() => {
          document.querySelector('#status').textContent = '已保存';
        }, 300);
      });
    </script>
  `);

  // 单次覆盖比把整个项目的 actionTimeout 调大更精确。
  await page.getByRole('button', { name: '保存' }).click({ timeout: 2_000 });
  await expect(page.locator('#status')).toHaveText('已保存', { timeout: 2_000 });
});

预期结果:页面在约 300 毫秒后出现“已保存”,点击和断言都在各自的 2 秒上限内完成,因此用例通过。使用下方命令验证:

bash
npx playwright test tests/timeout.spec.ts --reporter=line

预期输出中会看到用例通过,具体耗时会因机器而不同:

text
1 passed (<TIME>)

避免用固定等待“修复”超时

遇到偶发超时时,直接加入 page.waitForTimeout(5000) 往往只会把测试整体拖慢,而且无法保证五秒后条件一定成立。定位时应先看究竟是元素不可操作、导航未完成、断言条件未满足,还是测试整体预算不足,再调整最小必要层级。

优先使用 Locator 的自动等待和 expect(locator) 的 Web-First 断言,让测试等待“条件成立”而不是等待“固定秒数”。只有业务本身明确依赖时间流逝的场景,才应把时间作为测试条件处理;单纯把所有超时调大,会让真正的死锁、错误选择器和性能退化更晚暴露。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置测试超时

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

登录哪都通