如何阻止缺少标签的Cucumber Feature文件在WebdriverIO中运行

1. 配置 Cucumber 前置标签过滤 #

在 wdio.conf.js 的 cucumberOpts 配置项中显式定义标签表达式，让框架在执行前就完成用例过滤，而非启动会话后才过滤不匹配的用例：

// wdio.conf.js
export const config = {
  // 其他全局配置省略
  cucumberOpts: {
    // 按需调整标签规则，示例为仅执行带@Regression标签且不带@skip标签的用例
    tagExpression: '@Regression and not @skip',
    // 其余Cucumber配置项保留
  }
}

如果需要动态切换执行的标签，执行命令时直接传入参数即可：
npx wdio run wdio.conf.js --cucumberOpts.tagExpression="@Regression"

2. 开启会话懒加载 #

开启 WebdriverIO 内置的懒加载配置，只有匹配到需要执行的用例时才会启动 webdriver 会话：

// wdio.conf.js
export const config = {
  // 其他全局配置省略
  lazySessionInitialization: true,
  // 多运行器模式下额外添加以下配置避免重复过滤
  specFilterRetries: 0,
}

3. 预过滤 Feature 文件（可选优化） #

如果要进一步降低初始化开销，可以在配置加载阶段直接过滤掉完全不含目标标签的 Feature 文件：

// wdio.conf.js
import fs from 'fs'
import glob from 'glob'

const targetTag = '@Regression'
const filteredSpecs = glob.sync('./test/features/**/*.feature').filter(filePath => {
  const featureContent = fs.readFileSync(filePath, 'utf8')
  return featureContent.includes(targetTag)
})

export const config = {
  specs: filteredSpecs,
  // 其他全局配置省略
}

效果验证 #

修改配置后执行测试，查看运行日志中session created的触发记录，无标签的用例将不再触发会话创建。

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