Cucumber配置求助：如何通过CLI参数指定标签或运行全部测试

需求 #

实现：未通过CLI传入标签时运行所有场景；传入指定标签时仅运行对应标签的场景。

问题分析 #

1. 之前配置中设置tags: '@run or ""'时，逻辑不符合预期，无法实现动态切换。
2. 移除配置中tags项后，执行npm run test --tags="@api"仍运行全部测试，是因为npm传参方式错误：--tags被当成npm的参数，没有传递给cucumber-js，导致cucumber-js未收到标签指令，默认运行所有场景。

解决方案 #

方案1：修正CLI传参方式（最简单） #

步骤1：移除配置文件中的tags项

修改后的configs/cucumber.cjs：

module.exports = {
  default: {
    formatOptions: {
      snippetInterface: 'async-await'
    },
    paths: [
      'src/features/'
    ],
    dryRun: false,
    require: [
      'src/step_definitions/**/*.ts',
      'hooks.ts'
    ],
    requireModule: [
      'ts-node/register'
    ],
    format: [
      'json:test-results/json-report.json',
      'progress'
    ],
    parallel: process.env.CI ? 10 : 1
  }
}

步骤2：正确传递标签参数

使用--分隔npm参数与cucumber-js参数，确保标签指令被正确传递：

• 运行所有场景：

  npm run test
  

• 运行指定标签的场景：

  npm run test -- --tags="@api"
  

方案2：动态配置（适合复杂场景） #

如果需要更灵活的动态控制，可以通过环境变量在配置中动态设置标签：

步骤1：修改配置文件

在configs/cucumber.cjs中用环境变量动态判断标签：

module.exports = {
  default: {
    // 有环境变量则用指定标签，否则运行所有场景
    tags: process.env.CUCUMBER_TAGS || '*',
    formatOptions: {
      snippetInterface: 'async-await'
    },
    paths: [
      'src/features/'
    ],
    dryRun: false,
    require: [
      'src/step_definitions/**/*.ts',
      'hooks.ts'
    ],
    requireModule: [
      'ts-node/register'
    ],
    format: [
      'json:test-results/json-report.json',
      'progress'
    ],
    parallel: process.env.CI ? 10 : 1
  }
}

步骤2：修改package.json的测试脚本

"test": "cucumber-js --config=configs/cucumber.cjs ${TAGS:+--tags=\"$TAGS\"} || true"

步骤3：运行方式

• 运行所有场景：

  npm run test
  

• 运行指定标签（Linux/macOS）：

  TAGS="@api" npm run test
  

• 运行指定标签（Windows）：

  set TAGS=@api && npm run test
  

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