如何在Cypress中实现可复用的describe()或it()测试块？

你遇到的Cannot access 'itDisplayHello' before initialization报错，基本都是因为使用了函数表达式（比如const itDisplayHello = () => {}）定义封装逻辑，函数表达式不存在变量提升，在定义语句之前调用就会触发该错误。

方案1：用函数声明封装可复用测试块（最小改动修复） #

函数声明存在变量提升，同文件内任意位置都可调用，同时支持导出到其他spec文件复用，还可以传入用户类型、自定义参数适配不同场景。

1. 新建公共测试复用模块，比如spec-helpers/accessMatrixCommonTests.js

// 用函数声明定义可复用测试集合，支持传入用户类型作为参数
export function runCommonPermissionTests(userType) {
  it('should display Hello', () => {
    // 这里写通用测试逻辑，可使用传入的userType做差异化判断
    expect(page.helloText.isVisible()).toBe(true)
  })

  // 可以把其他重复的it/describe块都放在这里统一封装
  it('should match corresponding function permission', () => {
    // 通用权限校验逻辑
  })
}

2. 在业务spec文件中调用

import { runCommonPermissionTests } from '../spec-helpers/accessMatrixCommonTests'

describe('Admin user permission test', () => {
  beforeAll(() => {
    // 仅做当前文件独有的用户登录逻辑，切换不同用户类型
    login('admin')
  })
  // 直接调用封装好的通用测试块
  runCommonPermissionTests('admin')
})

describe('Normal user permission test', () => {
  beforeAll(() => {
    login('normal')
  })
  runCommonPermissionTests('normal')
})

方案2：封装高阶测试套件（适合整组describe复用） #

如果需要复用的是带前置逻辑的完整describe块，可以直接封装测试套件生成函数：

// 公共模块代码
export function definePermissionTestSuite(suiteName, userType, customBeforeHook = () => {}) {
  describe(suiteName, () => {
    beforeAll(() => {
      // 内置通用登录逻辑
      login(userType)
      // 支持传入自定义前置逻辑做扩展
      customBeforeHook()
    })

    it('should display Hello', () => {
      expect(page.helloText.isVisible()).toBe(true)
    })

    // 其他通用测试用例
  })
}

调用示例：

import { definePermissionTestSuite } from '../spec-helpers/accessMatrixCommonTests'

// 一行代码生成不同用户的完整测试套件
definePermissionTestSuite('Admin permission suite', 'admin')
definePermissionTestSuite('Editor permission suite', 'editor', () => {
  // 可传入自定义前置逻辑，比如提前为编辑用户生成测试数据
  initTestDocument()
})

其他注意事项 #

如果坚持使用函数表达式封装，只要把调用语句放在函数定义语句之后，也可以避免初始化报错。

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