如何在Cypress Cucumber测试中处理Uncaught:exception未捕获异常

你之前的代码报错是因为cy.on('uncaught:exception')是浏览器端的Cypress命令，只能在测试代码或支持文件中使用，而setupNodeEvents是运行在Node.js环境的配置函数，这里无法调用cy对象。以下是两种全局生效的正确实现方式：

方法1：通过Cypress支持文件全局配置 #

这是最直接的全局配置方案，所有Feature测试会自动继承该逻辑：

1. 打开Cypress支持文件（默认路径为cypress/support/e2e.js，旧版本可能是index.js）
2. 添加以下代码：

// 全局捕获未捕获异常，所有测试场景生效
Cypress.on('uncaught:exception', (err, runnable) => {
  // 可选：打印错误信息用于调试
  console.log('捕获到未捕获异常:', err.message);
  // 返回false阻止Cypress因该异常标记测试失败
  return false;
});

该文件中的代码会在所有测试文件（包括Cucumber步骤定义文件）加载前执行，确保全局生效。

方法2：通过Cucumber Hooks全局配置 #

如果需要结合Cucumber的钩子逻辑控制，可在公共步骤定义文件中添加Before钩子：

import { Before } from '@badeball/cypress-cucumber-preprocessor';

Before(() => {
  // 在每个Feature的首个场景执行前设置异常捕获
  Cypress.on('uncaught:exception', (err, runnable) => {
    console.log('捕获到未捕获异常:', err.message);
    return false;
  });
});

注意需确保该钩子文件被所有Feature的步骤定义引用，或在Cypress配置中设置自动加载该文件。

关键说明 #

setupNodeEvents是Node.js环境的配置函数，负责处理文件预处理器、插件等Node端逻辑，不存在浏览器端的cy或Cypress对象，因此无法在此处设置浏览器端的事件监听。浏览器端的异常捕获必须在Cypress的浏览器运行上下文（支持文件或测试钩子）中配置。

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