Cypress如何用cy.readFile()读取JSON测试数据并解决testData未定义问题

算力阿峰

2026-10-6

Cypress testData is not defined 报错解决方案

报错根因

作用域问题：testData是cy.readFile的then回调函数的入参，仅在回调内部可访问，在回调外直接调用该变量会触发未定义报错。
Cypress 异步执行逻辑：所有cy开头的命令都是异步入队执行，不会同步返回结果，无法在命令行后同步读取返回值。

修复方案

方案1：将数据挂载到上下文`this`使用

所有使用测试数据的逻辑都放入then回调中，同时注意测试用例不要使用箭头函数，避免this指向异常：

beforeEach(() => {
  // 确保代码中的 type、json 变量已提前定义赋值
  const type = "yourDataType"
  const json = {xxx: "xxx"}

  cy.readFile('cypress/fixtures/eoicorporate.json')
    .then(testData => {
      testData[type] = json
      // 将处理后的数据挂载到全局上下文
      this.testData = testData
    })
})

// 测试用例使用普通函数声明，不要用箭头函数
it('EOI 登录测试', function () {
  // 直接通过 this.testData 读取测试数据
  cy.get('#account').type(this.testData.account)
  cy.get('#password').type(this.testData.password)
  cy.get('#loginBtn').click()
})

方案2：使用Cypress别名机制存储数据

更符合Cypress原生写法，通过as()给数据取别名，后续直接通过别名读取：

beforeEach(() => {
  const type = "yourDataType"
  const json = {xxx: "xxx"}

  cy.readFile('cypress/fixtures/eoicorporate.json')
    .then(testData => {
      testData[type] = json
      return testData
    })
    // 给处理后的数据取别名
    .as('testData')
})

it('EOI 登录测试', function () {
  // 直接通过别名读取数据
  cy.get('#account').type(this.testData.account)
})