Установка

Введение​

Playwright Test был создан специально для удовлетворения потребностей тестирования взаимодействия с пользователем. Playwright поддерживает все современные движки рендеринга, включая Chromium, WebKit и Firefox. Тестируйте на Windows, Linux и macOS, локально или на CI, в бестелесной или телесной форме с эмуляцией мобильных устройств на базе Google Chrome для Android и Mobile Safari.

Вы узнаете

• Как установить Playwright
• Что установлено
• Как запустить пример теста
• Как открыть отчет HTML-тестов

Установка Playwright​

Начните с установки Playwright с помощью npm, yarn или pnpm. Кроме того, вы можете начать и запустить свои тесты, используя расширение VS Code.

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.

Запуск примера теста​

По умолчанию тесты будут запускаться во всех трех браузерах (Chromium, Firefox и WebKit) с использованием 3 рабочих процессов. Это можно настроить в файле playwright.config. Тесты выполняются в бестелесном режиме, т. е. браузер не открывается при запуске тестов. Результаты тестов и журналы тестов будут отображаться в терминале.

npx playwright test

yarn playwright test

pnpm exec playwright test

Дополнительную информацию о запуске тестов в телесном режиме, запуске нескольких тестов и запуске конкретных тестов см. в нашей документации по Запуску тестов.

Отчеты HTML-тестов​

После завершения теста будет сгенерирован отчет HTML-отчет, который предоставляет полный отчет о ваших тестах, позволяя фильтровать отчет по браузерам, пройденным тестам, не пройденным тестам, пропущенным тестам и нестабильным тестам. Вы можете перейти к каждому тесту и изучить ошибки теста, а также каждый шаг теста. По умолчанию HTML-отчет автоматически открывается, если некоторые тесты завершились неудачно.

npx playwright show-report

yarn playwright show-report

pnpm exec playwright show-report

Запуск примера теста в режиме UI​

Запустите свои тесты в режиме UI для лучшего опыта разработчика с отладкой с перемещением во времени, режимом наблюдения и многим другим.

npx playwright test --ui

yarn playwright test --ui

pnpm exec playwright test --ui

Ознакомьтесь с подробным руководством по режиму UI, чтобы узнать больше о его функциях.

Обновление Playwright​

Для обновления Playwright до последней версии выполните следующую команду:

npm install -D @playwright/test@latest
# Also download new browser binaries and their dependencies:
npx playwright install --with-deps

yarn add --dev @playwright/test@latest
# Also download new browser binaries and their dependencies:
yarn playwright install --with-deps

pnpm install --save-dev @playwright/test@latest
# Also download new browser binaries and their dependencies:
pnpm exec playwright install --with-deps

Вы всегда можете проверить используемую версию Playwright, выполнив следующую команду:

npx playwright --version

yarn playwright --version

pnpm exec playwright --version

Системные требования​

• Node.js 18+
• Windows 10+, Windows Server 2016+ или Windows Subsystem for Linux (WSL).
• macOS 13 Ventura или более поздние версии.
• Debian 12, Ubuntu 22.04, Ubuntu 24.04 на архитектурах x86-64 и arm64.

Что дальше​

• Напишите тесты, используя ассерты, основанные на web-элементах, фикстуры страниц и локаторы
• Запустите отдельный тест, несколько тестов, телесный режим
• Генерируйте тесты с помощью Codegen
• Просмотрите трассировку ваших тестов