如何修复Cypress测试抛出的jest/no-standalone-expect ESLint错误？

jest/no-standalone-expect是Jest生态的ESLint规则，默认要求expect断言必须写在Jest的测试块（test/it函数）内部，禁止出现在普通回调、异步函数等脱离测试块的场景中。

你遇到报错的核心原因是ESLint配置同时加载了Jest和Cypress的规则，且没有对两类测试文件做区分：

1. 你当前的Cypress用例写法完全符合Cypress异步链式调用的规范，测试运行通过就说明逻辑没有问题
2. 这个expect嵌套在两层.then()回调中，ESLint的Jest规则没有识别到外层的Cucumber Then步骤函数/ Cypress测试块，误判为「脱离测试上下文的独立断言」，所以触发了报错
3. 其他写法类似的expect没有报错，大概率是没有嵌套多层.then()，被规则正确识别到了外层的测试块上下文

你可以根据自己的项目配置任选以下一种方案：

• 方案1：调整规则的全局适配配置，在你的.eslintrc.js（或其他格式的ESLint配置文件）中给该规则添加Cypress场景的白名单函数：

module.exports = {
  // 其余原有配置保持不变
  rules: {
    'jest/no-standalone-expect': [
      'error',
      {
        // 允许在Cypress的then、should回调，以及Cucumber步骤函数中使用expect
        additionalTestBlockFunctions: ['then', 'should', 'Given', 'When', 'Then']
      }
    ]
  }
}

• 方案2：给Cypress测试目录单独配置规则，如果你项目的Jest单元测试和Cypress E2E测试分目录存放，更推荐用目录级覆盖规则避免两类测试的规则冲突：

module.exports = {
  // 其余原有配置保持不变
  overrides: [
    {
      // 路径匹配你实际的Cypress用例存放目录即可
      files: ['cypress/e2e/**/*.{js,ts,jsx,tsx}'],
      rules: {
        'jest/no-standalone-expect': 'off'
      }
    }
  ]
}

• 方案3：临时单行忽略，如果你不想修改全局配置，可以直接在报错的expect行上方加忽略注释：

// eslint-disable-next-line jest/no-standalone-expect
expect(heading).to.match(new RegExp(interceptedRequest.thing)); 

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