在Cypress中复用测试套件和测试用例的进阶策略

// cypress/support/utils/reusableTests.js

/**
 * 定义一个可复用的测试套件函数。
 * 当需要在一个新的测试文件中完整调用此套件时，可以导入并执行此函数。
 */
export function commonTestSuite() {
  describe('可复用通用测试套件', () => {
    beforeEach(() => {
      cy.log('执行通用套件的 beforeEach 钩子');
      // 可以在这里添加此套件特有的前置操作
    });

    it('通用测试用例 A - 验证功能 X', () => {
      cy.log('执行通用测试用例 A');
      // 实际的测试逻辑，例如：
      // cy.get('#element-x').should('be.visible');
    });

    it('通用测试用例 B - 验证功能 Y', () => {
      cy.log('执行通用测试用例 B');
      // 实际的测试逻辑，例如：
      // cy.get('#element-y').click();
      // cy.url().should('include', '/next-page');
    });

    afterEach(() => {
      cy.log('执行通用套件的 afterEach 钩子');
    });
  });
}

/**
 * 定义一个可复用的独立测试用例函数。
 * 当只需要在其他套件中插入单个特定用例时，可以导入并执行此函数。
 * 注意：it块必须在一个describe块内部执行。
 */
export function commonTestCase() {
  it('可复用独立测试用例 - 检查特定元素', () => {
    cy.log('执行可复用独立测试用例');
    // 实际的测试逻辑，例如：
    // cy.get('.specific-item').should('have.length', 5);
  });
}

// 如果需要复用带有特定参数的测试逻辑，也可以这样封装
export function testWithParameters(param1, param2) {
  it(`参数化测试用例 - ${param1} 和 ${param2}`, () => {
    cy.log(`执行参数化测试，参数1: ${param1}, 参数2: ${param2}`);
    // 使用传入的参数执行测试逻辑
    // cy.get(`#${param1}`).type(param2);
  });
}

// cypress/e2e/mainTest.cy.js
import { commonTestSuite, commonTestCase, testWithParameters } from '../support/utils/reusableTests';

describe('主应用测试套件', () => {
  beforeEach(() => {
    cy.visit('/'); // 假设所有测试都需要访问应用的根目录
  });

  it('主套件的第一个独立测试用例', () => {
    cy.log('执行主套件的独立测试');
    // ... 主套件特有的测试逻辑
  });

  // 场景一：调用整个可复用测试套件
  // 这将在当前describe块的上下文中执行commonTestSuite中定义的所有describe和it块。
  // 注意：commonTestSuite内部的describe块会形成嵌套。
  commonTestSuite();

  // 场景二：在当前describe块中调用单个可复用测试用例
  // commonTestCase函数内部已经包含了it块，直接调用即可。
  commonTestCase();

  // 场景三：调用带有参数的可复用测试用例
  testWithParameters('usernameField', 'testUser');
  testWithParameters('passwordField', 'testPass');


  it('主套件的最后一个独立测试用例', () => {
    cy.log('执行主套件的最后一个独立测试');
    // ... 更多主套件特有的测试逻辑
  });
});