TypeScript的BDD Cucumber框架中Playwright测试超时配置无效的解决

问题根源 #

你遇到的5000ms超时错误来自@cucumber/cucumber，这是Cucumber的默认步骤超时时间，和Playwright配置文件里的timeout无关——因为playwright.config.ts是给Playwright自带的测试运行器用的，Cucumber不会解析这个文件的配置项，所以你把它加到cucumber.json的require里完全没用。

解决方案 #

1. 全局设置Cucumber步骤超时

直接修改cucumber.json，添加全局timeout字段，值和你Playwright配置里的保持一致即可：

{
    "default": {
        "paths": ["./BDD/Features/*.feature"],
        "require": [
            "./BDD/Steps/*.ts",
            "./BDD/Hooks/Hooks.ts"
        ],
        "requireModule": ["ts-node/register"],
        "forceExit": true,
        "timeout": 120000 // 替换成你需要的超时时间，比如120秒
    }
}

2. 单独调整单个步骤的超时

如果某个步骤需要特殊的超时时间，可以在步骤定义里直接覆盖全局设置：

import { When } from '@cucumber/cucumber';

// 给这个步骤单独设置120秒超时
When('User launches Youtube', { timeout: 120000 }, async function () {
    // 你的测试步骤代码，比如page.goto('https://youtube.com')
});

3. 补充配置Playwright自身的操作超时

除了Cucumber的步骤超时，Playwright内部的操作（比如页面导航、元素点击）也有自己的超时，建议在playwright.config.ts里补充配置：

const config: PlaywrightTestConfig = {
  use: {
    headless: Config.headless,
    video: { mode: 'on' },
    viewport: null,
    actionTimeout: 30000, // 单个操作（点击、输入等）的超时
    navigationTimeout: 60000, // 页面导航的超时
  },
  outputDir: './TestResults',
  timeout: 120000, // 这个只对TDD模式生效
  fullyParallel: true,
  reporter: [['junit', { outputFile: './TestResults/TestResults.xml' }]]
};

总结 #

• TDD模式用Playwright测试运行器，所以读取playwright.config.ts的timeout；
• BDD模式用Cucumber运行，步骤超时由Cucumber管理，必须在Cucumber的配置或步骤定义里设置；
• 两者的超时是独立的，建议都配置好，避免出现两种不同的超时报错。

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