Cypress执行完所有it块后自动退出测试运行环境问题求解

问题现象 #

编写Cypress自动化测试用例时，采用外层describe嵌套多层子describe与it块的结构，希望将每个测试步骤拆分到对应describe下的独立it块中，方便查看完整测试历史记录。实际运行出现异常：所有测试用例执行完成后，Cypress自动退出测试运行环境返回主菜单，无法保留各it块的测试历史条目。
仅当将所有测试命令包裹在同一个describe下的单个it块中时，测试运行完成后才不会自动退出，可正常查看结果。

异常结构示例代码 #

describe("Move timetable until the specified event is executed", () => {
  describe("Login", () => {
    it("should log in and retrive the timetable related info", () => {
      cy.login()
    });
  });
  describe("Access dedicated menu leaf", () => {
    it("should access the Maintenance menu and click on Execute", () => {
      executeCurrentTimetable.accessMenuLeafAndClickExecute();
    });

    describe("Execute events until specified event is executed", () => {
      it("should execute the timetable until a specified event is reached", () => {
        // get the event based on eventsList array
        executeCurrentTimetable.executeEvents(eventKeyObj.SoBD);
  });
});

正常单it块参考代码 #

describe("Execute events until last event of the day", () => {
  it.only("should execute the timetable until a specified event is reached", () => {
    cy.login()
    executeCurrentTimetable.accessMenuLeafAndClickExecute();
    executeCurrentTimetable.executeLastEvent();
  });
});

根因说明 #

1. 示例异常代码存在基础语法错误：多层嵌套的花括号、括号未正常闭合，会导致Cypress解析用例结构异常，执行完成后直接退出运行环境。
2. Cypress 12+版本默认开启测试隔离机制：每个it块执行前会自动重置页面上下文、清空登录会话与缓存，拆分后的it块之间上下文断裂，后续用例无合法运行环境，执行完成后直接退回主重复。
3. Cypress默认配置下，单个spec文件内所有用例执行完成后，会自动返回spec选择主菜单，不会停留在当前用例的执行结果页。

修复方案 #

• 首先修复代码语法错误，补全所有缺失的闭合括号，修正后的基础嵌套结构如下：

describe("Move timetable until the specified event is executed", () => {
  describe("Login", () => {
    it("should log in and retrive the timetable related info", () => {
      cy.login()
    });
  });
  describe("Access dedicated menu leaf", () => {
    it("should access the Maintenance menu and click on Execute", () => {
      executeCurrentTimetable.accessMenuLeafAndClickExecute();
    });

    describe("Execute events until specified event is executed", () => {
      it("should execute the timetable until a specified event is reached", () => {
        // get the event based on eventsList array
        executeCurrentTimetable.executeEvents(eventKeyObj.SoBD);
      });
    });
  });
});

• 关闭测试隔离配置，保留跨it块的运行上下文，可选择单文件配置或者全局配置：
  • 单spec文件生效：在文件最顶部添加配置代码

    Cypress.config('testIsolation', false)
    

  • 全局生效：在cypress.config.js的e2e配置块中添加testIsolation: false配置项。
• 调整用例结构，将强依赖的前置公共步骤放到beforeEach钩子中执行，避免后续it块因为缺少前置上下文运行失败，示例结构如下：

Cypress.config('testIsolation', false)
describe("Move timetable until the specified event is executed", () => {
  beforeEach(() => {
    cy.login()
    executeCurrentTimetable.accessMenuLeafAndClickExecute();
  })
  it("should log in and retrive the timetable related info", () => {
    // 校验登录后时刻表信息拉取逻辑
  });
  it("should access the Maintenance menu and click on Execute", () => {
    // 校验菜单跳转逻辑
  });
  it("should execute the timetable until a specified event is reached", () => {
    executeCurrentTimetable.executeEvents(eventKeyObj.SoBD);
    // 校验事件执行结果
  });
});

• 禁用执行完自动返回主菜单的行为：启动Cypress时添加--no-exit参数，即使用cypress open --no-exit命令启动运行器，所有用例执行完成后会停留在结果页，可正常查看所有it块的执行历史。

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