如何在Cypress的before:run函数中设置全局变量作用于所有Spec？

问题根源 #

before:run 钩子运行在Node.js环境，而测试代码（spec文件）运行在浏览器环境，两个环境的上下文完全隔离，直接设置的变量无法跨环境共享，这就是你取不到值的核心原因。

方法一：通过Cypress环境变量传递 #

在cypress.config.js的before:run钩子中修改Cypress配置的环境变量，测试代码通过Cypress.env()读取：

// cypress.config.js
const { defineConfig } = require('cypress')

module.exports = defineConfig({
  experimentalInteractiveRunEvents: true,
  e2e: {
    setupNodeEvents(on, config) {
      on('before:run', (details) => {
        // 将变量写入环境变量
        config.env.globalTestVar = '预设置的全局变量值'
        // 必须返回修改后的config，否则配置更新不生效
        return config
      })
    },
  },
})

在spec文件中读取：

// 测试spec文件
it('读取before:run设置的变量', () => {
  const varValue = Cypress.env('globalTestVar')
  console.log(varValue) // 输出预设置的变量值
})

方法二：通过cy.task从Node环境获取 #

如果变量需要异步生成（比如读取文件、调用接口），可以注册cy.task让浏览器端主动从Node环境获取变量：

// cypress.config.js
const { defineConfig } = require('cypress')

module.exports = defineConfig({
  experimentalInteractiveRunEvents: true,
  e2e: {
    setupNodeEvents(on, config) {
      let asyncGeneratedVar
      
      on('before:run', async (details) => {
        // 模拟异步操作生成变量，比如读取配置文件
        asyncGeneratedVar = await new Promise(resolve => {
          setTimeout(() => resolve('异步生成的变量'), 1000)
        })
      })

      // 注册task供测试代码调用
      on('task', {
        getAsyncVar: () => {
          return asyncGeneratedVar
        }
      })
    },
  },
})

在spec文件中调用task获取：

// 测试spec文件
it('获取异步生成的变量', () => {
  cy.task('getAsyncVar').then(varValue => {
    console.log(varValue) // 输出异步生成的变量值
  })
})

注意事项 #

• 确保experimentalInteractiveRunEvents配置为true，这个配置是让Cypress交互模式（cypress open）也能触发before:run钩子，命令行模式（cypress run）默认支持该钩子。
• 如果before:run中有异步操作，必须使用async/await确保变量设置完成后再进入测试流程。

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