升级@badeball/cypress-cucumber-preprocessor后Cypress测试无法运行

问题根源 #

1. 预处理器版本不兼容：@badeball/cypress-cucumber-preprocessor 15.x版本对esbuild预处理器的依赖要求更新，旧版@bahmutov/cypress-esbuild-preprocessor ^2.1.5无法适配，导致构建时依赖的common-ancestor-path库触发空数组reduce错误。
2. Cypress配置未适配：Cypress 12.x的测试检测逻辑和配置结构有调整，旧版cypress.config.js的预处理器注册方式不再适配新版本的插件要求。

修复步骤 #

1. 升级兼容的esbuild预处理器 #

卸载旧版本并安装最新兼容版：

npm uninstall @bahmutov/cypress-esbuild-preprocessor
npm install @bahmutov/cypress-esbuild-preprocessor@latest

2. 更新cypress.config.js配置 #

新版本的@badeball/cypress-cucumber-preprocessor需要调整预处理器的注册方式，示例配置如下：

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) {
      // 创建esbuild打包器并集成cucumber插件
      const bundler = createBundler({
        plugins: [createEsbuildPlugin(config)],
      });

      on("file:preprocessor", bundler);
      // 注册cucumber预处理器插件
      await addCucumberPreprocessorPlugin(on, config);

      return config;
    },
    // 确保specPattern指向你的feature文件路径
    specPattern: "cypress/e2e/**/*.feature",
  },
});

• 注意根据你的项目目录结构调整specPattern的路径。
• 必须确保addCucumberPreprocessorPlugin是异步调用并返回config。

3. 清理依赖缓存并重装 #

删除旧依赖缓存避免冲突：

rm -rf node_modules package-lock.json
npm install

4. 验证feature文件与步骤定义匹配 #

新版本预处理器对步骤匹配的严格性有所提升，检查所有feature文件中的场景步骤是否与对应的步骤定义文件完全一致（包括参数、拼写）。

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