Cypress是否支持所有测试用例执行前的预检查功能？

结论 #

可以实现，无需在启动Cypress前运行自定义脚本，通过Cypress原生提供的节点事件钩子即可满足需求。

实现步骤 #

1. 配置cypress.config.js/ts的节点事件
   在Cypress配置文件的setupNodeEvents回调中注册两个钩子：

• before:run：所有spec执行前仅触发1次，用于执行全局检查逻辑，记录检查结果和错误信息
• before:spec：每个spec执行前都会触发，若全局检查未通过则直接抛出错误，将当前spec标记为执行失败
  示例代码如下：

const { defineConfig } = require("cypress");

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      // 存储全局检查状态与错误信息
      let isGlobalCheckPass = true
      let globalCheckError = ""

      on('before:run', async () => {
        try {
          // 此处写入你的检查逻辑，例如环境变量校验
          if (!config.env.REQUIRED_ENV) {
            throw new Error("必要环境变量REQUIRED_ENV未配置")
          }
          // 其他检查逻辑可在此处扩展
        } catch (err) {
          isGlobalCheckPass = false
          globalCheckError = err.message
          // 直接在终端打印错误调试信息
          console.error('\x1b[31m全局前置检查失败：\x1b[0m', globalCheckError)
        }
      })

      on('before:spec', async (spec) => {
        if (!isGlobalCheckPass) {
          // 抛出错误将当前spec标记为失败
          throw new Error(`全局检查不通过，spec ${spec.relative} 终止执行：${globalCheckError}`)
        }
      })
    },
  },
});

2. （可选）补充浏览器侧校验
   如果你需要在浏览器执行层也做校验，可以在cypress/support/e2e.js中添加全局前置钩子，每个spec的测试用例执行前都会触发该检查：

before(() => {
  if (!Cypress.env('REQUIRED_ENV')) {
    throw new Error("必要环境变量REQUIRED_ENV未配置")
  }
})

效果说明 #

• 全局检查仅执行1次，不会重复消耗性能
• 检查失败的调试信息会直接输出到运行Cypress的终端中
• 所有spec都会被标记为执行失败，无需修改现有测试用例代码

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