如何处理Playwright中超时终止的长UI测试？

可能的原因及解决方案 #

1. 超时设置的作用域错误 #

test.setTimeout()必须放在测试用例的函数内部才能生效，放在测试文件顶层或describe块里只会设置默认超时，无法覆盖单个测试的限制。正确写法：

test('长时间运行的UI测试', async ({ page }) => {
  test.setTimeout(2147483647); // 在此处设置
  // 你的测试逻辑
});

2. 被其他层级的超时配置覆盖 #

Playwright的超时是多层级的，以下设置都可能覆盖你的test.setTimeout()：

• 全局配置文件（playwright.config.js）中的timeout字段
• 测试用例定义时传入的timeout参数（如test('...', { timeout: 120000 }, async () => {})）
• 单个页面操作的超时（如page.waitForSelector('#element', { timeout: 30000 })）

检查这些配置，确保没有更低优先级的设置覆盖你想要的超时时间。

3. 未使用正确的API设置超时 #

如果使用自定义Fixtures，需要在fixture内部或测试用例定义时明确设置超时：

• 用例定义时直接传参数：

test('长时间运行的UI测试', { timeout: 2147483647 }, async ({ page }) => {
  // 测试逻辑
});

• Fixture中设置：

const test = baseTest.extend({
  page: async ({ page }, use) => {
    test.setTimeout(2147483647);
    await use(page);
  },
});

4. 异步操作未正确等待 #

有时候测试提前终止并非超时，而是某个异步操作没加await导致测试提前进入结束流程。确保所有UI操作、网络请求等待都用await包裹：

await page.fill('#username', 'test-user');
await page.click('#submit');
await page.waitForLoadState('networkidle'); // 等待页面加载完成

内容的提问来源于stack exchange，提问作者vei nen