如何在cypress-cucumber-preprocessor中用标签同时过滤Spec与Feature测试？

方案一：自定义Cypress插件实现统一标签过滤 #

通过编写自定义插件，同时处理两类测试的标签过滤逻辑，完全自主控制规则，规避第三方库的兼容问题。

1. 给Spec测试添加标签
   在你的.cy.js文件中，用Cypress支持的tags属性标记测试（兼容cypress-grep的格式）：

// cypress/tests/gsac/specs/login.cy.js
describe('登录功能', { tags: ['@smoke', '@auth'] }, () => {
  it('正常登录', { tags: ['@smoke'] }, () => {
    // 测试逻辑
  });

  it('错误密码登录', { tags: ['@negative'] }, () => {
    // 测试逻辑
  });
});

2. 编写自定义过滤插件
   在cypress.config.js的setupNodeEvents中添加统一处理逻辑：

// cypress.config.js
const { defineConfig } = require('cypress');
const createBundler = require('@bahmutov/cypress-esbuild-preprocessor');
const { addCucumberPreprocessorPlugin } = require('@badeball/cypress-cucumber-preprocessor');
const createEsbuildPlugin = require('@badeball/cypress-cucumber-preprocessor/esbuild');

module.exports = defineConfig({
  e2e: {
    async setupNodeEvents(on, config) {
      await addCucumberPreprocessorPlugin(on, config);

      on(
        'file:preprocessor',
        createBundler({
          plugins: [createEsbuildPlugin(config)],
        })
      );

      // 统一处理标签过滤
      const unifiedTags = config.env.unifiedTags;
      if (unifiedTags) {
        // 传给Cucumber测试用的tags参数
        config.env.tags = unifiedTags;
        // 传给Spec测试用的grepTags参数，借助cypress-grep的匹配逻辑
        require('cypress-grep/src/plugin')(on, config);
        config.env.grepTags = unifiedTags;
      }

      return config;
    },
    specPattern: ['cypress/tests/gsac/specs/*.cy.js', 'cypress/tests/gsac/*.feature'],
  },
});

3. 安装依赖并执行测试
   先安装cypress-grep用于处理Spec的标签匹配：

npm install cypress-grep --save-dev

然后用统一的环境变量参数运行：

cypress run --env unifiedTags='@smoke and not @slow'

方案二：调整cypress-grep兼容逻辑 #

如果偏好使用cypress-grep，可通过修改插件加载逻辑实现兼容：

1. 修改Cypress配置的插件顺序
   确保cucumber预处理器先加载，再给cypress-grep添加过滤规则：

// cypress.config.js
async setupNodeEvents(on, config) {
  await addCucumberPreprocessorPlugin(on, config);

  // 先初始化Cucumber预处理器
  on(
    'file:preprocessor',
    createBundler({
      plugins: [createEsbuildPlugin(config)],
    })
  );

  // 让cypress-grep只处理非.feature文件
  require('cypress-grep/src/plugin')(on, config, {
    filterSpecs: (spec) => !spec.endsWith('.feature'),
  });

  // 同步标签参数：如果只传了tags，自动同步给grepTags
  if (config.env.tags && !config.env.grepTags) {
    config.env.grepTags = config.env.tags;
  }

  return config;
}

2. 运行测试命令
   现在可以直接用Cucumber的tags参数，插件会自动同步给Spec测试：

cypress run --env tags='@smoke and not @slow'

方案三：文件命名辅助过滤（简易版） #

如果标签规则固定，可通过文件命名后缀快速过滤，比如给需要执行的测试文件加-smoke后缀：

cypress run --spec "cypress/tests/gsac/specs/*-smoke.cy.js,cypress/tests/gsac/*-smoke.feature"

这个方法无需额外配置，适合规则固定的场景。

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