# playwright-expert

Субагент playwright-expert для e2e-тестов на Playwright: прогоны в Chromium, Firefox и WebKit, page object, скриншотные сравнения, моки запросов.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 763 у репозитория
- Автор: carlrannaberg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/e2e/e2e-playwright-expert.md
- Обновлён: 2026-03-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/carlrannaberg-playwright-expert

## Что делает

Субагент берёт на себя e2e-тесты на Playwright: браузерные проекты для Chromium, Firefox и WebKit, классы Page Object, сравнение скриншотов, подмену сетевых запросов и обвязку для CI. Список инструментов — Bash, Read, Write, Edit, MultiEdit, Grep, Glob — позволяет ему открывать файлы тестов, править их и запускать команды.

Сначала он смотрит, с чем имеет дело: `npx playwright --version`, наличие `playwright.config.js` или `.ts`, каталогов `tests` или `e2e`, потом разбирает проекты браузеров и репортёры в конфиге. Дальше идёт по типовым сбоям: тест зелёный в Chromium и красный в Firefox, локатор цепляет три элемента, таймаут на сетевом запросе, скриншот расходится между платформами, метод page object вызван до перехода на страницу. К каждому — причина, правка в коде и команда диагностики вроде `npx playwright test --project=firefox --debug` или `npx playwright codegen`.

Файл кладут в `.claude/agents/e2e-playwright-expert.md`, причём имя внутри отличается от имени файла. Если в проекте нет ни установленного Playwright, ни конфига, читать ему нечего: проверка окружения закончится пустым результатом.

## Требования
- Работает с: Playwright

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/e2e-playwright-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/e2e-playwright-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/e2e-playwright-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/e2e/e2e-playwright-expert.md

## Когда брать
- развести тесты по проектам Chromium, Firefox и WebKit в одном конфиге
- переписать локаторы на `getByRole` и `getByLabel` вместо CSS-цепочек
- убрать гонки ожиданий через web-first ассерты и `waitForResponse`
- настроить порог `maxDiffPixels` и маски для скриншотных тестов
- изолировать тестовые данные через `beforeEach` и `afterEach`

## Примеры запросов агенту
- Тест проходит в Chromium, но падает в WebKit — разберись и почини конфиг проектов.
- Замени хрупкие CSS-селекторы в `tests/login.spec.ts` на семантические локаторы.
- Скриншотный тест всё время красный — настрой `maxDiffPixels` и замаскируй динамический блок.

## Похожие
- [playwright](https://affpapa.org/nevibecode/skills/bobmatnyc-playwright.md) — скилл · 930 установок
- [playwright-testing](https://affpapa.org/nevibecode/skills/laurigates-playwright-testing.md) — скилл · 106 установок
- [browserstack](https://affpapa.org/nevibecode/skills/browserstack.md) — скилл · 1614 установок
- [qa-game](https://affpapa.org/nevibecode/skills/qa-game.md) — скилл · 1000 установок
- [playwright-skill](https://affpapa.org/nevibecode/skills/testmu-ai-playwright-skill.md) — скилл · 564 установки
- [playwright-in-sandbox](https://affpapa.org/nevibecode/skills/playwright-in-sandbox.md) — скилл · 510 установок

## Другие версии с тем же именем
- [playwright-expert · 0xfurai](https://affpapa.org/nevibecode/agents/playwright-expert.md) — ★ 1029 у репозитория

Из того же набора: [carlrannaberg/claudekit](https://affpapa.org/nevibecode/by/carlrannaberg/claudekit.md) — 54 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
