Генератор тестов 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 в соответствии со следующим приоритетом:
getByRole()— Элемент имеет явную ARIA-рольgetByText()— Элемент имеет чёткое текстовое содержимоеgetByLabel()— Элемент формы имеет связанную меткуgetByPlaceholder()— Поле ввода имеет placeholdergetByAltText()— У изображения есть атрибут altgetByTestId()— У элемента есть data-testidgetByTitle()— У элемента есть атрибут titlelocator()— 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 |