Установка
Введение
Playwright Test был создан специально для удовлетворения потребностей в end-to-end тестировании. Playwright поддерживает все современные движки рендеринга, включая Chromium, WebKit и Firefox. Тестируйте на Windows, Linux и macOS, локально или на CI, в безголовом или обычном режиме с нативной эмуляцией мобильных устройств Google Chrome для Android и Mobile Safari.
Вы узнаете
- Как установить Playwright
- Что установлено
- Как запустить пример теста
- Как открыть HTML отчет о тестировании
Установка Playwright
Начните с установки Playwright с помощью npm, yarn или pnpm. В качестве альтернативы вы также можете начать и запустить свои тесты, используя расширение VS Code.
- npm
- yarn
- pnpm
npm init playwright@latest
yarn create playwright
pnpm create playwright
Запустите команду установки и выберите следующее, чтобы начать:
- Выберите между TypeScript или JavaScript (по умолчанию TypeScript)
- Название папки с тестами (по умолчанию tests или e2e, если у вас уже есть папка tests в проекте)
- Добавьте рабочий процесс GitHub Actions для легкого запуска тестов на CI
- Установите браузеры Playwright (по умолчанию true)
Что установлено
Playwright загрузит необходимые браузеры, а также создаст следующие файлы.
playwright.config.ts
package.json
package-lock.json
tests/
example.spec.ts
tests-examples/
demo-todo-app.spec.ts
playwright.config – это место, где вы можете добавить конфигурацию для Playwright, включая изменение браузеров, на которых вы хотите запускать Playwright. Если вы запускаете тесты в уже существующем проекте, зависимости будут добавлены непосредственно в ваш package.json
.
Папка tests
содержит базовый пример теста, чтобы помочь вам начать тестирование. Для более детального примера ознакомьтесь с папкой tests-examples
, которая содержит тесты, написанные для тестирования приложения todo.
Запуск примера теста
По умолчанию тесты будут запускаться на всех 3 браузерах: Chromium, Firefox и WebKit, используя 3 рабочих процесса. Это можно настроить в файле playwright.config. Тесты запускаются в безголовом режиме, что означает, что браузер не откроется при запуске тестов. Результаты тестов и логи тестов будут показаны в терминале.
- npm
- yarn
- pnpm
npx playwright test
yarn playwright test
pnpm exec playwright test
Ознакомьтесь с нашей документацией по запуску тестов, чтобы узнать больше о запуске тестов в обычном режиме, запуске нескольких тестов, запуске конкретных тестов и т.д.
HTML отчеты о тестах
После завершения теста будет сгенерирован HTML отчет, который покажет вам полный отчет о ваших тестах, позволяя фильтровать отчет по браузерам, пройденным тестам, неудачным тестам, пропущенным тестам и нестабильным тестам. Вы можете нажать на каждый тест и изучить ошибки теста, а также каждый шаг теста. По умолчанию HTML отчет открывается автоматически, если некоторые из тестов не прошли.
- npm
- yarn
- pnpm
npx playwright show-report
yarn playwright show-report
pnpm exec playwright show-report
Запуск примера теста в UI режиме
Запустите свои тесты в UI режиме для улучшенного опыта разработчика с отладкой с перемоткой времени, режимом наблюдения и многим другим.
- npm
- yarn
- pnpm
npx playwright test --ui
yarn playwright test --ui
pnpm exec playwright test --ui
Ознакомьтесь с нашим подробным руководством по UI режиму, чтобы узнать больше о его функциях.
Обновление Playwright
Чтобы обновить Playwright до последней версии, выполните следующую команду:
- npm
- yarn
- pnpm
npm install -D @playwright/test@latest
# Также загрузите новые бинарные файлы браузеров и их зависимости:
npx playwright install --with-deps
yarn add --dev @playwright/test@latest
# Также загрузите новые бинарные файлы браузеров и их зависимости:
yarn playwright install --with-deps
pnpm install --save-dev @playwright/test@latest
# Также загрузите новые бинарные файлы браузеров и их зависимости:
pnpm exec playwright install --with-deps
Вы всегда можете проверить, какая версия Playwright у вас установлена, выполнив следующую команду:
- npm
- yarn
- pnpm
npx playwright --version
yarn playwright --version
pnpm exec playwright --version
Системные требования
- Последняя версия Node.js 18, 20 или 22.
- Windows 10+, Windows Server 2016+ или Windows Subsystem for Linux (WSL).
- macOS 13 Ventura или новее.
- Debian 12, Ubuntu 22.04, Ubuntu 24.04 на архитектуре x86-64 и arm64.