Генератор тестов Playwright Codegen

В этой главе рассматривается генератор тестов Playwright Codegen для командной строки, который автоматически генерирует тестовый код через операции в браузере.


Что такое Codegen

Codegen (Code Generator) — это встроенный инструмент Playwright для интерактивной генерации тестов.

Вы работаете в браузере как обычный пользователь, а Codegen автоматически преобразует ваши действия в тестовый код Playwright.


Запуск Codegen

# 基本用法:打开一个 URL 并开始录制
npx playwright codegen https://www.example.com/

# 指定代码生成的语言(默认 TypeScript)
npx playwright codegen --target=javascript https://www.example.com/
npx playwright codegen --target=python https://www.example.com/

После запуска откроются два окна:

  • Окно браузера: Вы взаимодействуете со страницей в этом окне
  • Окно Playwright Inspector: Отображает сгенерированный код в реальном времени

Запись операций

Когда вы выполняете любое действие в окне браузера, Codegen автоматически генерирует соответствующий код Playwright:

Навигация

Ввод нового URL в адресную строку и нажатие Enter генерируетpage.goto()оператор.

Щелчок

Клик по любому элементу (кнопке, ссылке, меню) генерируетpage.getByRole(...).click()или аналогичный код поиска и клика.

Ввод

Ввод текста в поле ввода генерируетpage.getByLabel(...).fill(...)илиpage.getByPlaceholder(...).fill(...)。

Выбор

Выбор параметра из выпадающего меню генерируетpage.getByLabel(...).selectOption(...)。

Флажок

Установка или снятие флажка генерируетpage.getByLabel(...).check()или.uncheck()。


Автоматический выбор лучшего локатора

Codegen анализирует атрибуты элементов страницы и генерирует Locator в соответствии со следующим приоритетом:

  1. getByRole()— Элемент имеет явную ARIA-роль
  2. getByText()— Элемент имеет чёткое текстовое содержимое
  3. getByLabel()— Элемент формы имеет связанную метку
  4. getByPlaceholder()— Поле ввода имеет placeholder
  5. getByAltText()— У изображения есть атрибут alt
  6. getByTestId()— У элемента есть data-testid
  7. getByTitle()— У элемента есть атрибут title
  8. locator()— CSS-селектор (в крайнем случае)

Если Codegen находит несколько подходящих элементов, он автоматически оптимизирует Locator до тех пор, пока целевой элемент не удастся однозначно идентифицировать.


Генерация проверок

На панели инструментов окна Inspector можно нажать кнопку проверки, чтобы сгенерировать код проверки:

  • Проверка видимости— выберите элемент после клика, генерируетawait expect(locator).toBeVisible()
  • Проверка текста— Генерируетawait expect(locator).toHaveText(...)
  • Проверка значения— Генерируетawait expect(locator).toHaveValue(...)
  • Проверка снимка— Генерируетawait expect(locator).toHaveScreenshot()

Общие параметры Codegen

ОпцияОписание
--target=javascriptСгенерировать код JavaScript (по умолчанию TypeScript)
--target=pythonСгенерировать код Python
--target=javaСгенерировать код Java
--target=csharpСгенерировать код C#
--save-storage=auth.jsonСохранить состояние аутентификации после записи
--load-storage=auth.jsonЗагрузить существующее состояние аутентификации перед записью
-o tests/test.spec.tsУказать выходной файл (по умолчанию — вывод в терминал)
--viewport-size=375,812Настраиваемый размер окна просмотра (имитация мобильных устройств)
--device="iPhone 15"Использовать предустановки устройств
--color-scheme=darkУказать цветовую схему

Codegen против записи в VS Code: как выбрать

МетодПрименимый сценарий
VS Code Record NewЕжедневная разработка тестов; код попадает прямо в редактор и может быть сразу изменён
Командная строка CodegenБыстрое прототипирование, кросс-языковая генерация кода, независимость от IDE
Другие расширения