如何在Cypress-Cucumber中获取当前步骤定义名称（非场景名称）

要获取步骤定义名称（而非场景名）并在测试失败时传入报告接口，核心思路是利用Cypress-Cucumber提供的步骤级钩子捕获并存储当前步骤信息，再在fail事件中读取该信息。

步骤1：添加步骤钩子存储步骤定义名称 #

在cypress/support/index.js（或专门的hooks文件）中添加AfterStep钩子，该钩子会在每个步骤执行完成后触发（无论成功/失败），直接从Cypress-Cucumber提供的step对象中获取步骤定义名称：

// 存储当前步骤定义名称到Node端存储（避免Cypress环境变量的上下文问题）
AfterStep((step) => {
  cy.task('setValue', { 
    key: 'currentStepName', 
    value: step.definition.name 
  }, { log: false });
});

// 可选：每个场景开始时清空步骤名称，避免场景间干扰
Before(() => {
  cy.task('setValue', { key: 'currentStepName', value: null }, { log: false });
});

步骤2：实现Node端存储的Task逻辑 #

在cypress/plugins/index.js中定义setValue和getValue两个Task，用于在Node端临时存储步骤名称（比Cypress环境变量更可靠，因为跨上下文）：

module.exports = (on, config) => {
  const tempStore = {};
  
  on('task', {
    setValue: ({ key, value }) => {
      tempStore[key] = value;
      return null;
    },
    getValue: (key) => {
      return tempStore[key] || 'Unknown Step';
    }
  });
  
  // 保留其他现有配置...
};

步骤3：修改fail事件获取步骤名称并生成报告 #

更新你原来的fail事件代码，先读取存储的步骤名称，再拼接成报告内容：

Cypress.on('fail', (error, runnable)=>{
  const errorName = Cypress._.toLower(error.name);
  const message = Cypress._.toLower(error.message);
  const isSkipped = message.includes('skip');

  // 先获取当前步骤名称，再处理报告逻辑
  cy.now('task', 'getValue', 'currentStepName', { log: false }).then(stepName => {
    const wholeMessage = `${stepName} / ${message}`;
    const status = isSkipped ? "Skipped" : "Failed";

    cy.now('task', 'getValue', 'currentScenario', { log: false }).then(scenarioName => {
      cy.now('postTestResult', "Complete", status, scenarioName, wholeMessage);
    });
  });

  throw error; // 保持原有的错误抛出逻辑，不影响Cypress的失败捕获
});

关键说明 #

• step.definition.name直接对应你编写的步骤定义文本（比如Given I open the login page中的完整文本），是Cypress-Cucumber内置提供的属性，无需解析Mocha的runnable对象。
• 使用Node端存储（Task）而非Cypress环境变量，是因为Cypress的环境变量在某些异步场景下可能存在上下文丢失问题，而Node端存储是全局唯一的，更稳定。
• AfterStep钩子会在步骤失败后依然触发，所以能确保失败的步骤名称被正确存储。

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