如何在Playwright+Cucumber+TypeScript中全局修改Expect超时时间

针对你用Playwright + Cucumber + TypeScript开发时想全局修改Expect默认超时的需求，最佳方案是创建一个预配置的Expect实例并全局导出，而非使用extend（extend主要用于添加自定义匹配器，不是修改默认超时）。具体步骤如下：

1. 创建全局配置的Expect实例 #

在项目中新建一个共享工具文件（比如src/utils/expect.ts），写入以下代码：

import { expect as playwrightExpect } from '@playwright/test';

// 配置全局超时为10秒
export const expect = playwrightExpect.configure({
  timeout: 10000,
});

2. 在所有步骤定义中使用这个全局Expect #

替换所有步骤文件中原本的import { expect } from '@playwright/test'，改为导入我们自己配置的版本：

// 替换之前的默认导入
import { expect } from '../utils/expect';
import { Given, When, Then } from '@cucumber/cucumber';

Then('我应该看到提交按钮', async function () {
  // 直接使用，自动应用10秒超时
  await expect(this.page.locator('button')).toHaveText('Submit');
});

为什么不使用extend？ #

Expect.extend()的作用是添加自定义匹配器（比如你自己写一个toBeVisibleWithCustomCheck()），它无法修改现有内置匹配器（如toBeVisible()、toHaveText()）的默认超时参数。而configure()方法正是Playwright官方提供的用于修改Expect全局默认配置（包括超时、软断言等）的方式。

额外说明 #

• 如果需要针对个别用例临时覆盖超时，依然可以在匹配器中单独设置：

  // 临时将这个断言的超时改为5秒，覆盖全局设置
  await expect(locator).toHaveText('Submit', { timeout: 5000 });
  

• 确保所有步骤文件都统一导入自定义的expect，避免混用默认导出导致配置不生效。

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