技能 编程开发 端到端测试框架指南

端到端测试框架指南

v20260423
running-e2e-tests
本指南提供了一个完整的端到端测试(E2E)框架和最佳实践。它指导用户如何模拟真实用户在整个应用栈(包括前端UI、API和数据库)上的全流程行为。内容涵盖了页面对象模型(POM)的构建、多浏览器配置、测试稳定性和各种错误处理的专业技巧,用于确保软件质量。
获取技能
499 次下载
概览

E2E Test Framework

Current State

!cat package.json 2>/dev/null | grep -oE 'playwright|cypress|selenium' || echo 'No E2E framework detected'

Overview

Execute end-to-end tests that simulate real user workflows across the full application stack -- browser interactions, API calls, database operations, and third-party integrations. Supports Playwright (recommended), Cypress, Selenium, and Puppeteer.

Prerequisites

  • E2E testing framework installed (Playwright, Cypress, or Selenium WebDriver)
  • Application running in a test environment with seeded test data
  • Browser binaries installed (npx playwright install or Cypress binary)
  • Test user accounts created with known credentials
  • Environment variables configured for base URL, API keys, and test credentials

Instructions

  1. Identify critical user journeys to cover:
  • User registration and login flow.
  • Primary feature workflow (e.g., create item, edit, delete).
  • Search and filtering functionality.
  • Checkout or payment flow (if applicable).
  • Error handling (404 pages, form validation, session expiry).
  1. Create page object models (POM) for reusable page interactions:
  • One class per page or major component.
  • Encapsulate locators, actions (click, fill, select), and assertions.
  • Use data-testid attributes as primary selectors for stability.
  1. Write E2E test files organized by user journey:
  • Each test file covers one complete workflow.
  • Use beforeEach to navigate to the starting page and reset state.
  • Use afterEach to capture screenshots on failure.
  • Keep tests independent -- no test should depend on another test's output.
  1. Handle authentication efficiently:
  • Store authenticated session state to a file (storageState in Playwright).
  • Reuse session across tests that require login.
  • Create a separate auth setup fixture that runs once per worker.
  1. Configure multi-browser and responsive testing:
  • Run tests on Chromium, Firefox, and WebKit.
  • Test at mobile (375px), tablet (768px), and desktop (1280px) viewports.
  • Use Playwright projects to define browser/viewport combinations.
  1. Add retry and stability mechanisms:
  • Use expect with auto-waiting locators (Playwright) instead of explicit waits.
  • Configure test retries (max 2) for CI environments.
  • Add networkidle or domcontentloaded wait conditions for page transitions.
  1. Generate test reports with screenshots, traces, and video on failure.

Output

  • E2E test files organized by user journey in tests/e2e/ or e2e/
  • Page object model classes in tests/e2e/pages/
  • Playwright/Cypress configuration file with browser and viewport matrix
  • Authentication state file for session reuse
  • HTML test report with screenshots, traces, and failure details

Error Handling

ErrorCauseSolution
Element not found / timeoutSelector changed or element lazy-loaded after timeoutUse data-testid attributes; increase timeout; use waitFor with proper state checks
Test passes locally but fails in CIHeadless browser behavior differs or CI is slowerRun CI in headless mode locally to reproduce; increase timeouts; check viewport size
Authentication state expiredStored session tokens have short TTLRegenerate auth state before each test run; use long-lived test account tokens
Flaky test due to animationClick registered before animation completesDisable CSS animations in test config; use force: true on click; add waitForLoadState
Database state pollutionPrevious test left data that affects current testSeed database in beforeEach; use transactional rollback; reset via API endpoint

Examples

Playwright test for user registration flow:

import { test, expect } from '@playwright/test';

test('new user can register and see dashboard', async ({ page }) => {
  await page.goto('/register');
  await page.getByTestId('name-input').fill('Test User');
  await page.getByTestId('email-input').fill('test@example.com');
  await page.getByTestId('password-input').fill('SecurePass123!');
  await page.getByTestId('register-button').click();

  await expect(page).toHaveURL(/\/dashboard/);
  await expect(page.getByTestId('welcome-message')).toContainText('Test User');
});

Page object model:

export class LoginPage {
  constructor(private page: Page) {}
  async login(email: string, password: string) {
    await this.page.goto('/login');
    await this.page.getByTestId('email').fill(email);
    await this.page.getByTestId('password').fill(password);
    await this.page.getByTestId('submit').click();
    await this.page.waitForURL(/\/dashboard/);
  }
}

Playwright config with multi-browser projects:

export default defineConfig({
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'mobile', use: { ...devices['iPhone 14'] } },
  ],
  use: { screenshot: 'only-on-failure', trace: 'on-first-retry' },
});

Resources

  • Playwright documentation: https://playwright.dev/docs/intro
  • Cypress documentation: https://docs.cypress.io/
  • Page Object Model pattern: https://playwright.dev/docs/pom
  • Playwright best practices: https://playwright.dev/docs/best-practices
  • E2E testing strategies: https://martinfowler.com/bliki/TestPyramid.html
信息
分类 编程开发
名称 running-e2e-tests
版本 v20260423
大小 3.47KB
更新时间 2026-10-05
语言