在Cypress中实现测试套件的模块化与复用

// cypress/support/reusableAuthTests.js

/**
 * 这是一个可复用的用户认证测试套件。
 * 它包含登录、登出等基本认证流程的测试。
 * @param {string} userType - 用于测试的用户类型，例如 'admin' 或 'standard'。
 */
export function myAuthTestSuite(userType = 'standard') {
  describe(`可复用的认证测试套件 - 用户类型: ${userType}`, () => {
    beforeEach(() => {
      // 可以在这里执行一些通用的前置操作，例如访问登录页面
      cy.visit('/login');
    });

    it('应该能够使用有效凭据成功登录', () => {
      // 根据userType执行不同的登录逻辑
      if (userType === 'admin') {
        cy.get('#username').type('adminUser');
        cy.get('#password').type('adminPass');
      } else {
        cy.get('#username').type('standardUser');
        cy.get('#password').type('standardPass');
      }
      cy.get('#loginButton').click();
      cy.url().should('include', '/dashboard');
      cy.contains('欢迎').should('be.visible');
    });

    it('应该在登录后显示正确的用户名', () => {
      // 假设登录后页面会显示用户名
      if (userType === 'admin') {
        cy.contains('Logged in as: adminUser').should('be.visible');
      } else {
        cy.contains('Logged in as: standardUser').should('be.visible');
      }
    });

    it('应该能够成功登出', () => {
      cy.get('#logoutButton').click();
      cy.url().should('include', '/login');
      cy.contains('登录').should('be.visible');
    });

    // 还可以添加更多相关的测试用例
  });
}

// 如果需要复用单个it块，可以这样导出：
export function testInvalidLogin() {
  it('应该拒绝无效的登录凭据', () => {
    cy.visit('/login');
    cy.get('#username').type('invalidUser');
    cy.get('#password').type('wrongPass');
    cy.get('#loginButton').click();
    cy.contains('用户名或密码错误').should('be.visible');
  });
}

// cypress/e2e/my-app.cy.js

// 从support目录导入可复用的测试套件
import { myAuthTestSuite, testInvalidLogin } from '../support/reusableAuthTests';

// 在主测试文件中调用整个认证测试套件
// 可以在不同的describe块中多次调用，并传入不同的参数
describe('应用程序核心功能测试', () => {
  before(() => {
    // 全局前置操作
  });

  // 调用标准用户认证测试
  myAuthTestSuite('standard');

  // 调用管理员用户认证测试
  // 注意：在同一个文件中连续调用多个describe块可能会导致测试上下文混淆
  // 更好的做法是在不同的spec文件中调用，或者确保每个describe块内部是完全独立的
  // myAuthTestSuite('admin');

  // 可以在这里添加其他与认证无关的测试
  it('应该能够访问主页', () => {
    cy.visit('/');
    cy.url().should('eq', Cypress.config().baseUrl + '/');
  });
});

// 也可以在一个独立的describe块中调用
describe('独立认证测试场景', () => {
  // 调用无效登录测试
  testInvalidLogin();

  it('应该在未登录时重定向到登录页', () => {
    cy.visit('/dashboard');
    cy.url().should('include', '/login');
  });
});

// reusable-form-tests.js
export function testFormSubmission(formSelector, data, expectedResult) {
  describe(`测试表单提交: ${formSelector}`, () => {
    it(`应该使用数据 ${JSON.stringify(data)} 成功提交`, () => {
      cy.get(formSelector).within(() => {
        for (const key in data) {
          cy.get(`[name="${key}"]`).type(data[key]);
        }
        cy.get('button[type="submit"]').click();
      });
      cy.contains(expectedResult).should('be.visible');
    });
  });
}

// my-spec.cy.js
import { testFormSubmission } from './reusable-form-tests';

describe('不同表单的提交测试', () => {
  testFormSubmission('#registrationForm', { name: 'John Doe', email: 'john@example.com' }, '注册成功');
  testFormSubmission('#contactForm', { subject: 'Inquiry', message: 'Hello' }, '消息已发送');
});