Cypress接入Cucumber运行测试提示步骤实现缺失报错求助

Cypress接入Cucumber执行测试时抛出运行异常，错误信息如下：

Error: Step implementation missing for: I am on the link
at Context.resolveAndRunStepDefinition (http://localhost:58088/__cypress/test
at Context.eval (http://localhost:58088/__cypress/tests?p=cypress\integration

package.json 配置 #

{
  "scripts": {
    "cypress-open": "cypress open",
    "cypress-feature": "cypress run --spec **/*.feature"
  },
  "devDependencies": {
    "cypress": "^9.6.1",
    "cypress-cucumber-preprocessor": "^4.3.1",
    "cypress-xpath": "^1.6.2"
  },
  "cypress-cucumber-preprocessor": {
    "nonGlobalStepDefinitions": true
  }
}

cypress.json 配置 #

{
    "testFiles" :"**/*.feature"   
}

项目目录结构参考 #

这个报错是cypress-cucumber-preprocessor没有匹配到对应步骤的实现代码，结合当前开启nonGlobalStepDefinitions: true非全局步骤模式的配置，按以下顺序排查修复：

• 检查cypress/plugins/index.js是否正确注册了Cucumber预处理器，漏配这步是高频问题，插件文件需添加如下配置：

const cucumber = require('cypress-cucumber-preprocessor').default
module.exports = (on, config) => {
  on('file:preprocessor', cucumber())
}

• 确认步骤文件路径符合非全局模式的规则：每个.feature文件同目录下，需要有和feature文件同名的文件夹存放该feature对应的步骤定义。例如存在cypress/integration/home.feature，对应的步骤文件必须放在cypress/integration/home/目录下的js文件中，路径不匹配会直接导致步骤找不到。
• 检查步骤定义的匹配文本和feature里写的I am on the link完全一致，包括大小写、空格、标点，字符串/正则匹配存在偏差时会识别失败。
• 如果需要跨feature复用公共步骤，需要在package.json的cypress-cucumber-preprocessor配置块中添加"step_definitions": "cypress/support/step_definitions"字段，指定公共步骤的存放目录，否则预处理器默认不会扫描全局路径下的公共步骤。

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