Агенты Playwright

Подпишитесь на наш ТЕЛЕГРАМ КАНАЛ ПО АВТОМАТИЗАЦИИ ТЕСТИРОВАНИЯ

В этой статье вы узнаете об агентах Playwright, представленных в версии 1.56. Кроме того, вы увидите, на примерах разберем, как они работают.
В Playwright 1.56 появилось три вида агентов:

• Planner — планировщик
• Generator — генератор
• Healer — “хилер”, агент восстановления
  

Агентов можно сгенерировать автоматически, выполнив нужную команду — она зависит от используемого AI-редактора:

# Visual Studio Code -> Works for Cursor as well
npx playwright init-agents --loop=vscode
# Claude Code
npx playwright init-agents --loop=claude
# Opencode
npx playwright init-agents --loop=opencodeПользователи Cursor могут преобразовать сгенерированный файл в формат MDC и переместить его в папку .cursor/rules для продолжения работы.

Если вы работаете в Cursor, можете конвертировать сгенерированный файл в формат MDC и переместить его в .cursor/rules, чтобы продолжить работу.

Planner открывает страницу, которую нужно протестировать, анализирует её и на основе этого генерирует тест-кейсы в формате Markdown. Для примера возьмём корзину Trendyol: нам нужно, чтобы агент добавил товар в корзину и перешёл в неё перед началом анализа.

После анализа страницы он создаёт файл тест-плана в формате .md, закрывает браузер и завершает работу.

При просмотре сгенерированного плана видно, что сценарии действительно нужные. Он не ограничивается только функциональными сценариями — на странице логина он даже собрал проверки по безопасности (например, проверку XSS-уязвимостей и CSRF-защиту).

Теперь выберем один из кейсов, который создал Planner, и попробуем сгенерировать по нему автотест с помощью агента Generator. Для примера возьмем случайный кейс, где нужно увеличить количество товара в корзине.

Тест сгенерировался успешно. Агент автоматически прописал в beforeEach все необходимые шаги, которые обычно используются в корзинных тестах — логин, добавление рандомного товара — и полностью повторил структуру уже существующих spec-файлов. Он даже пишет тесты в том же стиле: ждёт реальные ответы, а не ставит «жёсткие» ожидания. Таким образом, даже нет необходимости его перерабатывать под свои стандарты.

Из шести запущенных тестов, прописанных в конфигурации Playwright, пять прошли успешно, а один упал. Чтобы разобраться с этим, подключаем агента Healer.

После включения Healer запускает тесты во всех проектах, вычисляет нестабильные (flaky) участки и, если проблема не воспроизводится сразу, повторяет провалившийся тест несколько раз, чтобы поймать нестабильность. Как только источник проблемы найден — он вносит логические правки.

Далее он вносит адекватные исправления по обнаруженным проблемам.

И вот результат.

Заключение

Агенты Playwright уже переросли статус простых инструментов, которые просто выполняют тесты. Теперь они активно участвуют в анализе, сопровождении и даже генерации сценариев. Каждый агент хорош по-своему. Например, Healer перезапускает упавшие шаги, анализирует изменения в UI, предлагает исправления и несколько раз прогоняет тесты, чтобы выявить нестабильные места. Planner способен генерировать неочевидные пользовательские сценарии и добавлять дополнительные проверки к существующим тестам. Generator анализирует уже написанные тесты, автоматически добавляет недостающие предусловия и создаёт новые тесты в том же стиле, что и существующий проект. В итоге тестовый набор становится ровнее, а ручной правки — в разы меньше.

С таким набором возможностей агенты Playwright ощутимо ускоряют работу и повышают качество тестов.

Больше подробностей — в официальной документации Playwright или в их видео на YouTube.

https://playwright.dev/docs/test-agents

Перевод статьи «Playwright Agents».