E2E Testing Patterns

Расширьте возможности Claude Code с помощью паттернов E2E-тестирования на Playwright. Реализуйте Page Object Models, исправляйте нестабильные тесты и автоматизируйте CI/CD-процессы для надежных веб-приложений.

Безопасность и тестирование ★ 172,651 GitHub (172,651 ★)

Этот навык предоставляет Claude комплексную структуру для создания стабильных, поддерживаемых и высокопроизводительных наборов сквозных тестов с использованием Playwright. Он охватывает всё: от стандартизированной организации проекта и реализации Page Object Model (POM) до продвинутой обработки flaky-тестов, управления артефактами и интеграции с CI/CD. Также включает специализированные шаблоны для сложных сценариев, таких как подключение Web3-кошельков и тестирование финансовых транзакций, чтобы Claude писал production-ready тестовый код, который бесшовно встраивается в современные процессы разработки.

Ключевые особенности

01Комплексная интеграция с CI/CD для GitHub Actions

02Стандартизированные шаблоны реализации Page Object Model (POM)

03172 651 звезда на GitHub

04Стратегии выявления и устранения flaky-тестов

05Продвинутое управление артефактами: трейсы, видео и скриншоты

06Специализированные шаблоны тестирования для Web3/кошельков и финансовых потоков

Варианты использования

01Автоматизация регрессионного тестирования сложных веб-приложений

02Снижение flakiness тестов и повышение надёжности CI/CD

03Внедрение стандартизированных архитектур тестирования в крупных командах разработки

name

e2e-testing

description

Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.

metadata

origin
ECC

E2E Testing Patterns

Comprehensive Playwright patterns for building stable, fast, and maintainable E2E test suites.

Test File Organization

tests/
├── e2e/
│   ├── auth/
│   │   ├── login.spec.ts
│   │   ├── logout.spec.ts
│   │   └── register.spec.ts
│   ├── features/
│   │   ├── browse.spec.ts
│   │   ├── search.spec.ts
│   │   └── create.spec.ts
│   └── api/
│       └── endpoints.spec.ts
├── fixtures/
│   ├── auth.ts
│   └── data.ts
└── playwright.config.ts

Page Object Model (POM)

import { Page, Locator } from '@playwright/test'

export class ItemsPage {
  readonly page: Page
  readonly searchInput: Locator
  readonly itemCards: Locator
  readonly createButton: Locator

  constructor(page: Page) {
    this.page = page
    this.searchInput = page.locator('[data-testid="search-input"]')
    this.itemCards = page.locator('[data-testid="item-card"]')
    this.createButton = page.locator('[data-testid="create-btn"]')
  }

  async goto() {
    await this.page.goto('/items')
    await this.page.waitForLoadState('networkidle')
  }

  async search(query: string) {
    await this.searchInput.fill(query)
    await this.page.waitForResponse(resp => resp.url().includes('/api/search'))
    await this.page.waitForLoadState('networkidle')
  }

  async getItemCount() {
    return await this.itemCards.count()
  }
}

Test Structure

import { test, expect } from '@playwright/test'
import { ItemsPage } from '../../pages/ItemsPage'

test.describe('Item Search', () => {
  let itemsPage: ItemsPage

  test.beforeEach(async ({ page }) => {
    itemsPage = new ItemsPage(page)
    await itemsPage.goto()
  })

  test('should search by keyword', async ({ page }) => {
    await itemsPage.search('test')

    const count = await itemsPage.getItemCount()
    expect(count).toBeGreaterThan(0)

    await expect(itemsPage.itemCards.first()).toContainText(/test/i)
    await page.screenshot({ path: 'artifacts/search-results.png' })
  })

  test('should handle no results', async ({ page }) => {
    await itemsPage.search('xyznonexistent123')

    await expect(page.locator('[data-testid="no-results"]')).toBeVisible()
    expect(await itemsPage.getItemCount()).toBe(0)
  })
})

Playwright Configuration

import { defineConfig, devices } from '@playwright/test'

export default defineConfig({
  testDir: './tests/e2e',
  fullyParallel: true,
  forbidOnly: !!process.env.CI,
  retries: process.env.CI ? 2 : 0,
  workers: process.env.CI ? 1 : undefined,
  reporter: [
    ['html', { outputFolder: 'playwright-report' }],
    ['junit', { outputFile: 'playwright-results.xml' }],
    ['json', { outputFile: 'playwright-results.json' }]
  ],
  use: {
    baseURL: process.env.BASE_URL || 'http://localhost:3000',
    trace: 'on-first-retry',
    screenshot: 'only-on-failure',
    video: 'retain-on-failure',
    actionTimeout: 10000,
    navigationTimeout: 30000,
  },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
    { name: 'mobile-chrome', use: { ...devices['Pixel 5'] } },
  ],
  webServer: {
    command: 'npm run dev',
    url: 'http://localhost:3000',
    reuseExistingServer: !process.env.CI,
    timeout: 120000,
  },
})

Flaky Test Patterns

Quarantine

test('flaky: complex search', async ({ page }) => {
  test.fixme(true, 'Flaky - Issue #123')
  // test code...
})

test('conditional skip', async ({ page }) => {
  test.skip(process.env.CI, 'Flaky in CI - Issue #123')
  // test code...
})

Identify Flakiness

npx playwright test tests/search.spec.ts --repeat-each=10
npx playwright test tests/search.spec.ts --retries=3

Common Causes & Fixes

Race conditions:

// Bad: assumes element is ready
await page.click('[data-testid="button"]')

// Good: auto-wait locator
await page.locator('[data-testid="button"]').click()

Network timing:

// Bad: arbitrary timeout
await page.waitForTimeout(5000)

// Good: wait for specific condition
await page.waitForResponse(resp => resp.url().includes('/api/data'))

Animation timing:

// Bad: click during animation
await page.click('[data-testid="menu-item"]')

// Good: wait for stability
await page.locator('[data-testid="menu-item"]').waitFor({ state: 'visible' })
await page.waitForLoadState('networkidle')
await page.locator('[data-testid="menu-item"]').click()

Artifact Management

Screenshots

await page.screenshot({ path: 'artifacts/after-login.png' })
await page.screenshot({ path: 'artifacts/full-page.png', fullPage: true })
await page.locator('[data-testid="chart"]').screenshot({ path: 'artifacts/chart.png' })

Traces

await browser.startTracing(page, {
  path: 'artifacts/trace.json',
  screenshots: true,
  snapshots: true,
})
// ... test actions ...
await browser.stopTracing()

Video

// In playwright.config.ts
use: {
  video: 'retain-on-failure',
  videosPath: 'artifacts/videos/'
}

CI/CD Integration

# .github/workflows/e2e.yml
name: E2E Tests
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test
        env:
          BASE_URL: ${{ vars.STAGING_URL }}
      - uses: actions/upload-artifact@v4
        if: always()
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 30

Test Report Template

# E2E Test Report

**Date:** YYYY-MM-DD HH:MM
**Duration:** Xm Ys
**Status:** PASSING / FAILING

## Summary
- Total: X | Passed: Y (Z%) | Failed: A | Flaky: B | Skipped: C

## Failed Tests

### test-name
**File:** `tests/e2e/feature.spec.ts:45`
**Error:** Expected element to be visible
**Screenshot:** artifacts/failed.png
**Recommended Fix:** [description]

## Artifacts
- HTML Report: playwright-report/index.html
- Screenshots: artifacts/*.png
- Videos: artifacts/videos/*.webm
- Traces: artifacts/*.zip

Wallet / Web3 Testing

test('wallet connection', async ({ page, context }) => {
  // Mock wallet provider
  await context.addInitScript(() => {
    window.ethereum = {
      isMetaMask: true,
      request: async ({ method }) => {
        if (method === 'eth_requestAccounts')
          return ['0x1234567890123456789012345678901234567890']
        if (method === 'eth_chainId') return '0x1'
      }
    }
  })

  await page.goto('/')
  await page.locator('[data-testid="connect-wallet"]').click()
  await expect(page.locator('[data-testid="wallet-address"]')).toContainText('0x1234')
})

Financial / Critical Flow Testing

test('trade execution', async ({ page }) => {
  // Skip on production — real money
  test.skip(process.env.NODE_ENV === 'production', 'Skip on production')

  await page.goto('/markets/test-market')
  await page.locator('[data-testid="position-yes"]').click()
  await page.locator('[data-testid="trade-amount"]').fill('1.0')

  // Verify preview
  const preview = page.locator('[data-testid="trade-preview"]')
  await expect(preview).toContainText('1.0')

  // Confirm and wait for blockchain
  await page.locator('[data-testid="confirm-trade"]').click()
  await page.waitForResponse(
    resp => resp.url().includes('/api/trade') && resp.status() === 200,
    { timeout: 30000 }
  )

  await expect(page.locator('[data-testid="trade-success"]')).toBeVisible()
})

⚙️ Что это

E2E Testing Patterns — это сборник готовых шаблонов и практик для написания сквозных (end-to-end) тестов на Playwright. Набор включает в себя рекомендации по структуре проекта, реализации Page Object Model (POM), настройке CI/CD, управлению артефактами (скриншоты, видео, трассировки), а также стратегии борьбы с «плавающими» (flaky) тестами.

Навык ориентирован на Frontend- и QA-инженеров, которые хотят создавать стабильные, быстрые и легко поддерживаемые E2E-тесты. Он даёт готовую архитектуру, которую можно сразу адаптировать под свой проект.

🧠 Как работает

🏗️ Структура тестового набора

Файлы организованы по функциональным модулям, отдельно выделены фикстуры (fixtures) и конфигурация playwright.config.ts:

tests/
├── e2e/
│   ├── auth/          // тесты авторизации
│   ├── features/      // тесты функций
│   └── api/           // тесты API
├── fixtures/           // общие данные и setup
└── playwright.config.ts

🧩 Page Object Model (POM)

Для каждого экрана создаётся отдельный класс (Page Object), который инкапсулирует:

Селекторы элементов — всегда через data-testid (это надёжнее, чем CSS-классы).
Методы взаимодействия — например, search(query), goto().
Ожидания — явное ожидание ответа от API (waitForResponse) и полной загрузки страницы (waitForLoadState).

Пример: класс ItemsPage хранит searchInput, itemCards, createButton, а метод search заполняет поле и ждёт, пока придёт ответ от /api/search.

🧪 Структура теста

Каждый тест использует describe / it (или test.describe / test), в beforeEach создаётся Page Object и переход на нужную страницу:

test.describe('Item Search', () => {
  let itemsPage: ItemsPage;

  test.beforeEach(async ({ page }) => {
    itemsPage = new ItemsPage(page);
    await itemsPage.goto();
  });

  test('should search by keyword', async ({ page }) => {
    await itemsPage.search('test');
    await expect(itemsPage.itemCards.first()).toContainText(/test/i);
    await page.screenshot({ path: 'artifacts/search-results.png' });
  });
});

Тесты проверяют как позитивные сценарии (результаты есть), так и негативные (нет результатов — проверяется [data-testid="no-results"]).

⚙️ Конфигурация Playwright

В playwright.config.ts настраиваются ключевые параметры:

Параллельный запуск (fullyParallel: true) — все тесты в разных файлах идут параллельно.
Повторы — в CI retries: 2, локально retries: 0, чтобы только в CI перезапускать упавшие тесты.
Репортеры — HTML (для локального просмотра), JUnit и JSON (для CI).
Артефакты — скриншоты (only-on-failure), видео (retain-on-failure), трассировка (on-first-retry).
Таймауты — actionTimeout: 10s, navigationTimeout: 30s.
Проекты — Chromium, Firefox, WebKit, Mobile Chrome (Pixel 5).
Web-сервер — автостарт npm run dev (на CI сервер не переиспользуется).

🔁 Flaky-тесты — причины и лечение

Выявление: запуск теста 10 раз подряд (--repeat-each=10) или с --retries=3.

Карантин: маркировка test.fixme(true, 'Flaky - Issue #123') — тест не выполняется, но остаётся в коде.

Пропуск в CI: test.skip(process.env.CI, 'Flaky in CI') — тест бежит только локально.

Основные причины flaky и исправления:

Гонки (race conditions) — вместо page.click() используй locator.click(), который сам ждёт стабильности.
Сеть — вместо waitForTimeout жди ответа API (waitForResponse).
Анимации — сначала дождись видимости элемента, потом networkidle, потом кликай.

📸 Управление артефактами

Скриншоты — всей страницы (fullPage: true) или конкретного элемента (locator.screenshot()).
Трассировка — запись всех действий (browser.startTracing).
Видео — настраивается в playwright.config.ts как video: 'retain-on-failure'.

Все артефакты сохраняются в директорию artifacts/.

🔄 CI/CD интеграция

GitHub Actions workflow:

Запуск на push и pull_request.
Установка зависимостей (npm ci), браузеров (npx playwright install --with-deps).
Запуск тестов с переменной окружения BASE_URL из секретов.
Загрузка отчёта в артефакты (actions/upload-artifact) с хранением 30 дней.

Шаблон отчёта включает: дату, длительность, статус, список упавших тестов со скриншотами и рекомендованными исправлениями.

🦊 Web3 / Wallet тестирование

Для тестов, где нужен кошелёк (MetaMask), используется мок через context.addInitScript. Подменяется глобальный window.ethereum с методами eth_requestAccounts и eth_chainId. Это позволяет тестировать подключение кошелька без реального провайдера.

💰 Финансовые / критичные потоки

Пример — тест на исполнение сделки:

Пропуск на продакшене (test.skip(process.env.NODE_ENV === 'production')).
Заполнение суммы, проверка превью, подтверждение, ожидание ответа от /api/trade.
Проверка элемента успеха [data-testid="trade-success"].

✅ Когда использовать

Когда проект на Playwright требует чёткой архитектуры тестов.
Чтобы внедрить Page Object Model в существующий набор или начать новый без боли.
Для настройки CI/CD с артефактами и отчётами.
Если flaky-тесты отнимают время — применить стратегии карантина, пропуска и перезапуска.
Для тестирования Web3 / финансовых сценариев с моками.

🔐 Важно знать

Все селекторы основаны на data-testid — убедись, что вёрстка содержит эти атрибуты.
В финансовых тестах добавлена защита от случайного запуска на продакшене — стоит внедрить аналогичный skip.
Мок для Web3 актуален только для MetaMask-подобных провайдеров; для других кошельков нужна адаптация.
Видео и трассировка заметно замедляют прогон в CI; в конфиге они включены только на перезапуск упавших тестов (retain-on-failure, on-first-retry).

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code e2e-testing

Источник: https://mcpmarket.com/tools/skills/e2e-testing-patterns-1777849928067

E2E Testing Patterns

Ключевые особенности

Варианты использования

E2E Testing Patterns

Test File Organization

Page Object Model (POM)

Test Structure

Playwright Configuration

Flaky Test Patterns

Quarantine

Identify Flakiness

Common Causes & Fixes

Artifact Management

Screenshots

Traces

Video

CI/CD Integration

Test Report Template

Wallet / Web3 Testing

Financial / Critical Flow Testing

⚙️ Что это

🧠 Как работает

🏗️ Структура тестового набора

🧩 Page Object Model (POM)

🧪 Структура теста

⚙️ Конфигурация Playwright

🔁 Flaky-тесты — причины и лечение

📸 Управление артефактами

🔄 CI/CD интеграция

🦊 Web3 / Wallet тестирование

💰 Финансовые / критичные потоки

✅ Когда использовать

🔐 Важно знать

Как управлять артефактами тестирования, такими как скриншоты и видео?

Можно ли использовать этот навык для тестирования Web3 или DApp?

Включает ли навык настройку CI/CD?

Как этот навык помогает бороться с flaky-тестами?

Какая структура файлов тестов рекомендуется?

Комментарии