Cypress使用ChanceJS生成随机数据跨测试文件复用失效问题

当前每次运行生成全新随机名称，核心是两点问题：

• 原constants.js存在基础写法错误：require('chance')仅引入依赖但未实例化，直接调用chance.word()本身就会触发未定义引用报错。
• 本质原因是Cypress的模块加载与测试隔离机制：Cypress运行测试过程中，会在spec文件加载、用例执行的不同阶段重新执行导入模块的顶层代码，且不同spec文件运行在独立执行上下文里。写在constants.js顶层的chance.word()会在每次模块被重新导入时执行一次，自然每次生成新值，无法保留第一次生成的结果。
• 额外注意：Cypress默认开启的测试隔离特性会在每个it用例执行前重置测试状态，普通JS模块变量不属于跨用例、跨spec的持久化存储介质，天生不适合存放这类需要全局共享的动态生成值。

方案1：基于Cypress环境变量存值（最推荐，零额外依赖） #

利用Cypress.env()全局可访问、运行期内不主动修改就不会重置的特性，仅在值不存在时生成一次随机名，后续所有用例、所有spec文件都读取同一份存储值，完全不会重复生成。
首先重写constants.js：

// constants.js
const Chance = require('chance');
const chance = new Chance();

// 仅当环境变量中不存在对应值时，才生成新的随机名
if (!Cypress.env('TEST_ITEM_NAME')) {
  Cypress.env('TEST_ITEM_NAME', chance.word());
}

export const constants = {
  // 用getter动态读取环境变量值，避免初始化时固定赋值导致的不同步
  get ITEM() {
    return Cypress.env('TEST_ITEM_NAME');
  }
}

原有两个测试文件的业务代码不需要任何修改，正常导入constants后调用constants.ITEM即可，整个测试运行周期内拿到的都是第一次生成的同一个随机名称。
如果需要每次跑完整测试套件时都生成全新的名称，只需要在全局支持文件（cypress/support/e2e.js，旧版本对应cypress/support/index.js）中加全局钩子清空旧值即可：

// support/e2e.js
before(() => {
  Cypress.env('TEST_ITEM_NAME', null);
})

方案2：基于临时文件存值（适合跨运行周期保留值的场景） #

如果需要Cypress重载、甚至重连后仍然保留之前生成的值，可以通过Cypress任务把生成的名称写入本地临时JSON文件，读取时直接从文件取值：
首先在cypress.config.js中注册对应任务：

// cypress.config.js
const { defineConfig } = require('cypress');
const fs = require('fs');
const path = require('path');
const Chance = require('chance');
const chance = new Chance();
const tempDataPath = path.join(__dirname, 'cypress/temp/test-random-data.json');

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('task', {
        getOrGenerateItemName() {
          // 临时文件不存在时生成新值写入
          if (!fs.existsSync(tempDataPath)) {
            fs.mkdirSync(path.dirname(tempDataPath), { recursive: true });
            const itemName = chance.word();
            fs.writeFileSync(tempDataPath, JSON.stringify({ itemName }));
            return itemName;
          }
          // 存在则直接读取已存的值
          const data = JSON.parse(fs.readFileSync(tempDataPath, 'utf8'));
          return data.itemName;
        },
        clearTempTestData() {
          if (fs.existsSync(tempDataPath)) fs.unlinkSync(tempDataPath);
          return null;
        }
      })
    }
  }
})

使用时在测试用例的前置钩子中先取值存入环境变量即可：

// 任意spec文件中
before(() => {
  cy.task('getOrGenerateItemName').then(name => {
    Cypress.env('TEST_ITEM_NAME', name);
  })
})

it('Add a Item', function(){
  cy.pass_credentials();
  cy.get('.dx-datagrid-toolbar-button > .dx-button-content > .dx-icon').click({force: true});
  cy.get('[id$=_Name]').type(Cypress.env('TEST_ITEM_NAME'));
})

每次跑全量测试前，在全局before钩子中调用cy.task('clearTempTestData')即可清空旧值，触发新随机名生成。

方案3：结合cy.session缓存（适合绑定业务状态的场景） #

如果生成的随机名称和创建的业务条目强绑定，可以在创建条目的用例中通过cy.session把条目名、条目创建状态一起缓存，后续用例直接从session中取值，还能避免重复创建条目浪费执行时间，适合用例存在明确依赖顺序的场景。

• 先在两个测试文件的用例中分别打印constants.ITEM的值，确认两个文件拿到的值不一致，先定位是模块重载导致的重复生成问题
• 检查Cypress的testIsolation配置：如果开启了该配置，每个it块之间会清空页面状态、重置部分全局变量，禁止把需要跨用例共享的值存在普通JS变量中
• 避免在模块顶层直接执行随机生成逻辑：Cypress中模块的加载时机不受单个用例控制，只要模块被重载就会重新执行顶层代码，导致值重复生成

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