К основному содержанию
скилл CX Codex

Playwright · gentleman-programming — скилл для Claude Code: E2E-тесты с Page Objects

Скилл для написания E2E-тестов на Playwright с паттерном Page Objects. Помогает строить тесты через исследование реального UI с MCP-инструментами, затем кодировать селекторы и проверки на основе точных данных.

Apache-2.0 194 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill playwright -a claude-code
Открыть на GitHub

Что делает playwright

Скилл учит использовать правильный поток: сначала навигация и скриншоты страницы через MCP-инструменты (если доступны), потом выписка реальных селекторов и юзерских действий, только потом написание теста. Включает шаблон Page Object Model с базовым классом для общих методов, приоритет селекторов (getByRole и getByLabel перед CSS-селекторами), а также правила организации файлов — все тесты одной страницы в один файл, с отдельным файлом page object.

Реструктуризирует тесты через отделение методов: повторяющиеся проверки типа ожидания уведомления — в BasePage, утилиты для генерации тестовых данных и setup/teardown — в helpers.ts. Требует Python и Playwright, уже установленные в проекте.

Какие задачи решает

  • писать E2E-тесты без предположений о DOM-структуре
  • организовать тесты в Page Object Model так, чтобы не дублировать код
  • выбрать нужный селектор: role, label или testId
  • переиспользовать page objects разных страниц в одном сценарии
  • отделить логику page objects от утилит и test data

Примеры запросов агенту

  • Напиши E2E-тест для входа: нужна проверка, что после логина редиректит на дэшборд
  • Добавь тест для валидации формы регистрации — проверь, что поле Email требует @
  • Создай Page Object для модального окна добавления карточки, выпишите селекторы через MCP

Как установить playwright

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill playwright -a claude-code

2Вручную: положить файлы

~/.claude/skills/playwright/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/playwright/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о playwright

Как установить playwright в Claude Code?

Запусти npx skills add Gentleman-Programming/Gentleman-Skills --skill playwright -a claude-code, затем открой ~/.claude/skills/playwright/SKILL.md. Убедись, что Playwright и Python установлены в проекте.

Что делает этот скилл?

Даёт шаблоны для написания E2E-тестов: как исследовать страницу через MCP, выписать селекторы, организовать Page Objects, переиспользовать методы через BasePage и helpers.ts, выбрать правильный приоритет селекторов.

Когда нужно использовать MCP-инструменты Playwright?

Перед написанием теста: навигируй на страницу, возьми снимок структуры, кликни на элементы, сними скриншоты состояний. Это даёт точные селекторы и подтверждает, что юзерский поток работает как надо. Если MCP не доступен, пиши тесты по документации кода.

Исходный текст

SKILL.md · Apache-2.0
---
name: playwright
description: >
  Playwright E2E testing patterns.
  Trigger: When writing E2E tests - Page Objects, selectors, MCP workflow.
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.1"
---

## MCP Workflow (MANDATORY If Available)

**⚠️ If you have Playwright MCP tools, ALWAYS use them BEFORE creating any test:**

1. **Navigate** to target page
2. **Take snapshot** to see page structure and elements
3. **Interact** with forms/elements to verify exact user flow
4. **Take screenshots** to document expected states
5. **Verify page transitions** through complete flow (loading, success, error)
6. **Document actual selectors** from snapshots (use real refs and labels)
7. **Only after exploring** create test code with verified selectors

**If MCP NOT available:** Proceed with test creation based on docs and code analysis.

**Why This Matters:**
- ✅ Precise tests - exact steps needed, no assumptions
- ✅ Accurate selectors - real DOM structure, not imagined
- ✅ Real flow validation - verify journey actually works
- ✅ Avoid over-engineering - minimal tests for what exists
- ✅ Prevent flaky tests - real exploration = stable tests
- ❌ Never assume how UI "should" work

## File Structure

```
tests/
├── base-page.ts              # Parent class for ALL pages
├── helpers.ts                # Shared utilities
└── {page-name}/
    ├── {page-name}-page.ts   # Page Object Model
    ├── {page-name}.spec.ts   # ALL tests here (NO separate files!)
    └── {page-name}.md        # Test documentation
```

**File Naming:**
- ✅ `sign-up.spec.ts` (all sign-up tests)
- ✅ `sign-up-page.ts` (page object)
- ✅ `sign-up.md` (documentation)
- ❌ `sign-up-critical-path.spec.ts` (WRONG - no separate files)
- ❌ `sign-up-validation.spec.ts` (WRONG)

## Selector Priority (REQUIRED)

```typescript
// 1. BEST - getByRole for interactive elements
this.submitButton = page.getByRole("button", { name: "Submit" });
this.navLink = page.getByRole("link", { name: "Dashboard" });

// 2. BEST - getByLabel for form controls
this.emailInput = page.getByLabel("Email");
this.passwordInput = page.getByLabel("Password");

// 3. SPARINGLY - getByText for static content only
this.errorMessage = page.getByText("Invalid credentials");
this.pageTitle = page.getByText("Welcome");

// 4. LAST RESORT - getByTestId when above fail
this.customWidget = page.getByTestId("date-picker");

// ❌ AVOID fragile selectors
this.button = page.locator(".btn-primary");  // NO
this.input = page.locator("#email");         // NO
```

## Scope Detection (ASK IF AMBIGUOUS)

| User Says | Action |
|-----------|--------|
| "a test", "one test", "new test", "add test" | Create ONE test() in existing spec |
| "comprehensive tests", "all tests", "test suite", "generate tests" | Create full suite |

**Examples:**
- "Create a test for user sign-up" → ONE test only
- "Generate E2E tests for login page" → Full suite
- "Add a test to verify form validation" → ONE test to existing spec

## Page Object Pattern

```typescript
import { Page, Locator, expect } from "@playwright/test";

// BasePage - ALL pages extend this
export class BasePage {
  constructor(protected page: Page) {}

  async goto(path: string): Promise<void> {
    await this.page.goto(path);
    await this.page.waitForLoadState("networkidle");
  }

  // Common methods go here (see Refactoring Guidelines)
  async waitForNotification(): Promise<void> {
    await this.page.waitForSelector('[role="status"]');
  }

  async verifyNotificationMessage(message: string): Promise<void> {
    const notification = this.page.locator('[role="status"]');
    await expect(notification).toContainText(message);
  }
}

// Page-specific implementation
export interface LoginData {
  email: string;
  password: string;
}

export class LoginPage extends BasePage {
  readonly emailInput: Locator;
  readonly passwordInput: Locator;
  readonly submitButton: Locator;

  constructor(page: Page) {
    super(page);
    this.emailInput = page.getByLabel("Email");
    this.passwordInput = page.getByLabel("Password");
    this.submitButton = page.getByRole("button", { name: "Sign in" });
  }

  async goto(): Promise<void> {
    await super.goto("/login");
  }

  async login(data: LoginData): Promise<void> {
    await this.emailInput.fill(data.email);
    await this.passwordInput.fill(data.password);
    await this.submitButton.click();
  }

  async verifyCriticalOutcome(): Promise<void> {
    await expect(this.page).toHaveURL("/dashboard");
  }
}
```

## Page Object Reuse (CRITICAL)

**Always check existing page objects before creating new ones!**

```typescript
// ✅ GOOD: Reuse existing page objects
import { SignInPage } from "../sign-in/sign-in-page";
import { HomePage } from "../home/home-page";

test("User can sign up and login", async ({ page }) => {
  const signUpPage = new SignUpPage(page);
  const signInPage = new SignInPage(page);  // REUSE
  const homePage = new HomePage(page);      // REUSE

  await signUpPage.signUp(userData);
  await homePage.verifyPageLoaded();  // REUSE method
  await homePage.signOut();           // REUSE method
  await signInPage.login(credentials); // REUSE method
});

// ❌ BAD: Recreating existing functionality
export class SignUpPage extends BasePage {
  async logout() { /* ... */ }  // ❌ HomePage already has this
  async login() { /* ... */ }   // ❌ SignInPage already has this
}
```

**Guidelines:**
- Check `tests/` for existing page objects first
- Import and reuse existing pages
- Create page objects only when page doesn't exist
- If test requires multiple pages, ensure all page objects exist (create if needed)

## Refactoring Guidelines

### Move to `BasePage` when:
- ✅ Navigation helpers used by multiple pages (`waitForPageLoad()`, `getCurrentUrl()`)
- ✅ Common UI interactions (notifications, modals, theme toggles)
- ✅ Verification patterns repeated across pages (`isVisible()`, `waitForVisible()`)
- ✅ Error handling that applies to all pages
- ✅ Screenshot utilities for debugging

### Move to `helpers.ts` when:
- ✅ Test data generation (`generateUniqueEmail()`, `generateTestUser()`)
- ✅ Setup/teardown utilities (`createTestUser()`, `cleanupTestData()`)
- ✅ Custom assertions (`expectNotificationToContain()`)
- ✅ API helpers for test setup (`seedDatabase()`, `resetState()`)
- ✅ Time utilities (`waitForCondition()`, `retryAction()`)

**Before (BAD):**
```typescript
// Repeated in multiple page objects
export class SignUpPage extends BasePage {
  async waitForNotification(): Promise<void> {
    await this.page.waitForSelector('[role="status"]');
  }
}
export class SignInPage extends BasePage {
  async waitForNotification(): Promise<void> {
    await this.page.waitForSelector('[role="status"]');  // DUPLICATED!
  }
}
```

**After (GOOD):**
```typescript
// BasePage - shared across all pages
export class BasePage {
  async waitForNotification(): Promise<void> {
    await this.page.waitForSelector('[role="status"]');
  }
}

// helpers.ts - data generation
export function generateUniqueEmail(): string {
  return `test.${Date.now()}@example.com`;
}

export function generateTestUser() {
  return {
    name: "Test User",
    email: generateUniqueEmail(),
    password: "TestPassword123!",
  };
}
```

## Test Pattern with Tags

```typescript
import { test, expect } from "@playwright/test";
import { LoginPage } from "./login-page";

test.describe("Login", () => {
  test("User can login successfully",
    { tag: ["@critical", "@e2e", "@login", "@LOGIN-E2E-001"] },
    async ({ page }) => {
      const loginPage = new LoginPage(page);

      await loginPage.goto();
      await loginPage.login({ email: "[email protected]", password: "pass123" });

      await expect(page).toHaveURL("/dashboard");
    }
  );
});
```

**Tag Categories:**
- Priority: `@critical`, `@high`, `@medium`, `@low`
- Type: `@e2e`
- Feature: `@signup`, `@signin`, `@dashboard`
- Test ID: `@SIGNUP-E2E-001`, `@LOGIN-E2E-002`

## Test Documentation Format ({page-name}.md)

```markdown
### E2E Tests: {Feature Name}

**Suite ID:** `{SUITE-ID}`
**Feature:** {Feature description}

---

## Test Case: `{TEST-ID}` - {Test case title}

**Priority:** `{critical|high|medium|low}`

**Tags:**
- type → @e2e
- feature → @{feature-name}

**Description/Objective:** {Brief description}

**Preconditions:**
- {Prerequisites for test to run}
- {Required data or state}

### Flow Steps:
1. {Step 1}
2. {Step 2}
3. {Step 3}

### Expected Result:
- {Expected outcome 1}
- {Expected outcome 2}

### Key verification points:
- {Assertion 1}
- {Assertion 2}

### Notes:
- {Additional considerations}
```

**Documentation Rules:**
- ❌ NO general test running instructions
- ❌ NO file structure explanations
- ❌ NO code examples or tutorials
- ❌ NO troubleshooting sections
- ✅ Focus ONLY on specific test case
- ✅ Keep under 60 lines when possible

## Commands

```bash
npx playwright test                    # Run all
npx playwright test --grep "login"     # Filter by name
npx playwright test --ui               # Interactive UI
npx playwright test --debug            # Debug mode
npx playwright test tests/login/       # Run specific folder
```

## Keywords
playwright, e2e, testing, page object model, selectors, end-to-end, mcp

© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — playwright от других авторов.

playwright secondsky Скилл для браузерной автоматизации и E2E-тестов на Playwright. Сам находит запущенный dev-сервер и пишет скрипты под вашу задачу. CX Codex +1 1 100установок playwright Mindrally Скилл playwright для автоматизации end-to-end тестов веб-приложений на TypeScript и JavaScript. Учит агента писать тесты по best practices: правильные локаторы, web-first assertions, отсутствие hardcoded таймаутов. CX Codex +1 1 100установок playwright PyModel С правилами по Playwright для Next.js. Включается при написании новых тестов, поиске плавающих падений и настройке CI. CX Codex +1 623установок playwright bobmatnyc Скилл Playwright для Claude Code: написание end-to-end тестов с локаторами, авто-ожиданием и кросс-браузерным прогоном. Покрывает пользовательские сценарии тестами. CX Codex +1 930установок playwright oakoss По Playwright: локаторы, ассерты, скриншоты и PDF, обход бот-защиты, авторизованные сессии, отладка ошибок. CX Codex +1 476установок playwright-testing alinaqi Скилл playwright-testing для E2E-тестов на Playwright: page objects, порядок локаторов и конфиг с прогоном в chromium, firefox, webkit и мобильных вьюпортах. CX Codex +1 3 400установок cypress-playwright-setup patricio0312rev Скилл cypress-playwright-setup для Claude Code, Codex, Cursor и других агентов, который разворачивает E2E-тестирование на Cypress или Playwright: page objects, фикстуры и CI-интеграция. CX Codex +1 313установок playwright-pro borghei Скилл playwright-pro для Claude Code, Codex и Cursor. Генерирует E2E-тесты на Playwright, настраивает Page Object, ищет причины флакующих проверок и переводит сценарии с Cypress или Selenium. CX Codex +1 148установок playwright-skill testdino.com Скилл снабжает агента 79 справочниками по Playwright 1.64 на TypeScript и JavaScript. Помогает писать тесты, разбирать падения в CI, настраивать моки и устранять флаки-сценарии. CX Codex +1 6 200установок playwright-expert https://github.com/Jeffallan Скилл playwright-expert настраивает E2E-тестирование на Playwright, создаёт классы Page Object и помогает устранять нестабильные проверки через трассировку. CX Codex +1 5 700установок playwright-cursor-rules Mindrally Скилл учит агента писать end-to-end тесты на Playwright по стандартам QA-автоматизации: стабильные локаторы, изоляция, параллельный запуск. CX Codex +1 738установок

Из того же набора20

Весь набор →
hexagonal-architecture-layers-java Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода. CX Codex +1 250установок angular-core Скилл angular-core учит агента современным паттернам Angular: standalone-компоненты, сигналы вместо хуков, zoneless-режим и встроенный control flow. CX Codex +1 230установок jira-task Скилл jira-task автоматизирует создание задач в Jira по стандарту Prowler. Генерирует структурированные баги, фичи и рефакторинги с правильными заголовками, критериями приёма и разбивкой по компонентам. CX Codex +1 217установок github-pr Скилл github-pr задаёт правила оформления пулл-реквестов по стандарту Conventional Commits и готовит вызовы gh pr create без рутины. CX Codex +1 205установок elixir-antipatterns Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок nextjs-15 Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware. CX Codex +1 185установок electron Организует структуру проекта на Electron, настраивает безопасный IPC через contextBridge и даёт типизированные шаблоны взаимодействия между процессами. CX Codex +1 175установок skill-creator Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы. CX Codex +1 171установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой