自动化测试 / 系统课时
配置测试超时
配置测试超时
自动化测试需要在“给正常页面足够时间”和“尽快暴露卡死”之间取平衡。本课会把 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 环境调整。
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 毫秒更新,因此无需人工休眠。
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 秒上限内完成,因此用例通过。使用下方命令验证:
npx playwright test tests/timeout.spec.ts --reporter=line预期输出中会看到用例通过,具体耗时会因机器而不同:
1 passed (<TIME>)避免用固定等待“修复”超时
遇到偶发超时时,直接加入 page.waitForTimeout(5000) 往往只会把测试整体拖慢,而且无法保证五秒后条件一定成立。定位时应先看究竟是元素不可操作、导航未完成、断言条件未满足,还是测试整体预算不足,再调整最小必要层级。
优先使用 Locator 的自动等待和 expect(locator) 的 Web-First 断言,让测试等待“条件成立”而不是等待“固定秒数”。只有业务本身明确依赖时间流逝的场景,才应把时间作为测试条件处理;单纯把所有超时调大,会让真正的死锁、错误选择器和性能退化更晚暴露。