如何在Cypress+Cucumber框架中捕获运行时传入的标签名

问题原因 #

你在测试代码中使用process.argv拿不到参数，是因为测试代码运行在Cypress的浏览器上下文里，这里的process并非Node.js环境中的process对象，自然获取不到命令行参数。正确的做法是从Cypress的配置对象中读取你传入的环境变量。

具体修改步骤 #

1. 在cypress.config.ts中捕获标签（Node.js环境）

在setupNodeEvents函数里，直接通过config.env.tags就能拿到你在脚本中传入的标签值，这里是Node.js运行环境，可以直接用来做后续操作（比如生成差异化报告、文件处理等）：

import { defineConfig } from "cypress";
import createBundler from "@bahmutov/cypress-esbuild-preprocessor";
import { addCucumberPreprocessorPlugin } from "@badeball/cypress-cucumber-preprocessor";
import createEsbuildPlugin from "@badeball/cypress-cucumber-preprocessor/esbuild";

export default defineConfig({
  e2e: {
    specPattern: '**/*.feature',
    baseUrl: "",
    watchForFileChanges:true,
    experimentalWebKitSupport:true,  
    async setupNodeEvents(on: Cypress.PluginEvents, config: Cypress.PluginConfigOptions): Promise<Cypress.PluginConfigOptions> {
      await addCucumberPreprocessorPlugin(on, config);

      // 捕获当前运行的标签
      const currentTag = config.env.tags;
      console.log("当前执行的测试标签:", currentTag);
      // 在这里可以直接用currentTag执行后续Node端操作

      // 如果需要在测试代码（浏览器上下文）中访问标签，确保它存在于env中
      config.env.currentTag = currentTag;

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

2. 在测试代码（Step定义）中使用标签

如果需要在Cucumber的Step定义里根据标签做差异化逻辑，直接用Cypress.env()获取即可：

// 示例Step定义
Given("执行标签相关逻辑", () => {
  const currentTag = Cypress.env("tags"); // 或Cypress.env("currentTag")
  if (currentTag === "@Sanity") {
    // 执行Sanity测试专属操作
  } else if (currentTag === "@Regression") {
    // 执行Regression测试专属操作
  }
});

3. 修正package.json脚本语法

你的原始脚本存在语法错误，补全闭合引号并简化写法：

"scripts": {
  "cy:smoke": "npx cypress run --env tags=\"@Sanity\"",
  "cy:regression": "npx cypress run --env tags=\"@Regression\""
}

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