Cypress测试套件与用例的模块化复用指南

// cypress/support/reusable-tests/common-suite.js

/**
 * 导出一个函数，该函数定义了一个可复用的Cypress测试套件。
 * @param {string} suiteName - 测试套件的名称。
 */
export function myReusableTestSuite(suiteName = '可复用测试套件') {
  describe(suiteName, () => {
    // 可以在这里放置 beforeEach, afterEach, before, after 等钩子
    beforeEach(() => {
      cy.log(`正在运行 ${suiteName} 中的测试用例...`);
      // 可以在这里执行一些通用设置，例如登录
      // cy.login('user', 'password');
    });

    it('测试用例1：验证基本功能', () => {
      cy.visit('/'); // 访问应用首页
      cy.get('h1').should('contain', '欢迎'); // 验证页面标题
      // 更多测试步骤...
    });

    it('测试用例2：验证数据加载', () => {
      cy.intercept('GET', '/api/data').as('getData');
      cy.visit('/data-page');
      cy.wait('@getData').its('response.statusCode').should('eq', 200);
      cy.get('.data-list').should('be.visible');
      // 更多测试步骤...
    });
  });
}

// cypress/e2e/featureA/testSuiteA.cy.js
import { myReusableTestSuite } from '../../support/reusable-tests/common-suite';

// 调用可复用测试套件
myReusableTestSuite('特性A的通用测试');

describe('特性A的特定测试', () => {
  it('特性A独有的用例1', () => {
    cy.visit('/featureA');
    cy.get('#featureA-element').should('be.visible');
  });
});

// cypress/e2e/featureB/testSuiteB.cy.js
import { myReusableTestSuite } from '../../support/reusable-tests/common-suite';

// 也可以传递不同的套件名称
myReusableTestSuite('特性B的通用测试');

describe('特性B的特定测试', () => {
  it('特性B独有的用例1', () => {
    cy.visit('/featureB');
    cy.get('#featureB-element').should('be.visible');
  });
});

// cypress/support/reusable-tests/common-cases.js

/**
 * 导出一个函数，该函数定义了一个可复用的Cypress测试用例。
 * @param {string} testCaseName - 测试用例的名称。
 */
export function verifyUserLogin(testCaseName = '验证用户登录') {
  it(testCaseName, () => {
    cy.visit('/login');
    cy.get('#username').type('testuser');
    cy.get('#password').type('password123');
    cy.get('button[type="submit"]').click();
    cy.url().should('include', '/dashboard');
    cy.get('.welcome-message').should('contain', 'testuser');
  });
}

export function checkPageTitle(title, testCaseName = `检查页面标题为 "${title}"`) {
  it(testCaseName, () => {
    cy.title().should('eq', title);
  });
}

// cypress/e2e/admin/admin-dashboard.cy.js
import { verifyUserLogin, checkPageTitle } from '../../support/reusable-tests/common-cases';

describe('管理员仪表盘测试', () => {
  // 在此套件中复用登录测试用例
  verifyUserLogin('管理员用户登录');

  beforeEach(() => {
    // 确保已登录，如果 verifyUserLogin 没有包含完整的登录流程
    // 或者在每次测试前重新登录
    cy.visit('/admin/dashboard');
  });

  // 在此套件中复用检查页面标题测试用例
  checkPageTitle('管理员仪表盘', '验证管理员仪表盘标题');

  it('验证管理员功能', () => {
    cy.get('.admin-panel').should('be.visible');
    // ...
  });
});

// cypress/e2e/user/user-profile.cy.js
import { verifyUserLogin } from '../../support/reusable-tests/common-cases';

describe('用户资料页测试', () => {
  verifyUserLogin('普通用户登录'); // 复用登录用例

  beforeEach(() => {
    cy.visit('/profile');
  });

  it('验证用户资料信息', () => {
    cy.get('#username-display').should('contain', 'testuser');
  });
});