Запуск и отладка тестов
Введение
С помощью Playwright вы можете запускать один тест, набор тестов или все тесты. Тесты могут быть запущены в одном браузере или в нескольких браузерах с использованием флага --project. По умолчанию тесты запускаются параллельно и в безголовом режиме, что означает, что окно браузера не будет открыто во время выполнения тестов, а результаты будут видны в терминале. Однако вы можете запустить тесты в режиме с графическим интерфейсом, используя аргумент CLI --headed, или вы можете запустить тесты в режиме UI, используя флаг --ui. Просмотрите полный трассировку ваших тестов с режимом наблюдения, отладкой с перемоткой времени и многим другим.
Вы узнаете
Запуск тестов
Командная строка
Вы можете запустить свои тесты с помощью команды playwright test. Это запустит ваши тесты во всех браузерах, как это настроено в файле playwright.config. По умолчанию тесты запускаются в безголовом режиме, что означает, что окно браузера не будет открыто во время выполнения тестов, а результаты будут видны в терминале.
npx playwright test
Запуск тестов в режиме UI
Мы настоятельно рекомендуем запускать ваши тесты в режиме UI для лучшего опыта разработки, где вы можете легко пройти через каждый шаг теста и визуально увидеть, что происходило до, во время и после каждого шага. Режим UI также включает в себя множество других функций, таких как выбор локатора, режим наблюдения и многое другое.
npx playwright test --ui
Ознакомьтесь с нашим подробным руководством по режиму UI, чтобы узнать больше о его функциях.
Запуск тестов в режиме с графическим интерфейсом
Чтобы запустить ваши тесты в режиме с графическим интерфейсом, используйте флаг --headed. Это даст вам возможность визуально увидеть, как Playwright взаимодействует с веб-сайтом.
npx playwright test --headed
Запуск тестов в разных браузерах
Чтобы указать, в каком браузере вы хотите запустить ваши тесты, используйте флаг --project, за которым следует имя браузера.
npx playwright test --project webkit
Чтобы указать несколько браузеров для запуска ваших тестов, используйте флаг --project несколько раз, за которым следует имя каждого браузера.
npx playwright test --project webkit --project firefox
Запуск конкретных тестов
Чтобы запустить один файл теста, передайте имя файла теста, который вы хотите запустить.
npx playwright test landing-page.spec.ts
Чтобы запустить набор файлов тестов из разных каталогов, передайте имена каталогов, в которых вы хотите запустить тесты.
npx playwright test tests/todo-page/ tests/landing-page/
Чтобы запустить файлы, содержащие landing или login в имени файла, просто передайте эти ключевые слова в CLI.
npx playwright test landing login
Чтобы запустить тест с определенным заголовком, используйте флаг -g, за которым следует заголовок теста.
npx playwright test -g "add a todo item"
Запуск последних неудачных тестов
Чтобы запустить только те тесты, которые не прошли в последнем запуске тестов, сначала запустите ваши тесты, а затем запустите их снова с флагом --last-failed.
npx playwright test --last-failed
Запуск тестов в VS Code
Тесты можно запускать прямо из VS Code с помощью расширения VS Code. После установки вы можете просто нажать на зеленый треугольник рядом с тестом, который вы хотите запустить, или запустить все тесты из боковой панели тестирования. Ознакомьтесь с нашим руководством по началу работы с VS Code для получения более подробной информации.
Отладка тестов
Поскольку Playwright работает в Node.js, вы можете отлаживать его с помощью вашего любимого отладчика, например, используя console.log или внутри вашей IDE, или прямо в VS Code с расширением VS Code. Playwright поставляется с режимом UI, где вы можете легко пройти через каждый шаг теста, увидеть логи, ошибки, сетевые запросы, исследовать снимок DOM и многое другое. Вы также можете использовать Playwright Inspector, который позволяет вам пошагово проходить вызовы API Playwright, видеть их отладочные логи и исследовать локаторы.
Отладка тестов в режиме UI
Мы настоятельно рекомендуем отлаживать ваши тесты в режиме UI для лучшего опыта разработки, где вы можете легко пройти через каждый шаг теста и визуально увидеть, что происходило до, во время и после каждого шага. Режим UI также включает в себя множество других функций, таких как выбор локатора, режим наблюдения и многое другое.
npx playwright test --ui
Во время отладки вы можете использовать кнопку Pick Locator, чтобы выбрать элемент на странице и увидеть локатор, который Playwright использовал бы для нахождения этого элемента. Вы также можете редактировать локатор в игровом поле локаторов и видеть его выделение в реальном времени в окне браузера. Используйте кнопку Copy Locator, чтобы скопировать локатор в буфер обмена, а затем вставить его в ваш тест.
Ознакомьтесь с нашим подробным руководством по режиму UI, чтобы узнать больше о его функциях.
Отладка тестов с помощью Playwright Inspector
Чтобы отладить все тесты, выполните команду Playwright test с флагом --debug.
npx playwright test --debug
Эта команда откроет окно браузера, а также Playwright Inspector. Вы можете использовать кнопку step over в верхней части инспектора, чтобы пошагово пройти ваш тест. Или нажмите кнопку play, чтобы запустить ваш тест от начала до конца. После завершения теста окно браузера закроется.
Чтобы отладить один файл теста, выполните команду Playwright test с именем файла теста, который вы хотите отладить, с флагом --debug.
npx playwright test example.spec.ts --debug
Чтобы отладить конкретный тест с номера строки, где определен test(.., добавьте двоеточие, за которым следует номер строки в конце имени файла теста, с флагом --debug.
npx playwright test example.spec.ts:10 --debug
Во время отладки вы можете использовать кнопку Pick Locator, чтобы выбрать элемент на странице и увидеть локатор, который Playwright использовал бы для нахождения этого элемента. Вы также можете редактировать локатор и видеть его выделение в реальном времени в окне браузера. Используйте кнопку Copy Locator, чтобы скопировать локатор в буфер обмена, а затем вставить его в ваш тест.
Ознакомьтесь с нашим руководством по отладке, чтобы узнать больше об отладке с помощью отладчика VS Code, режима UI и Playwright Inspector, а также об отладке с помощью инструментов разработчика браузера.
Отчеты о тестах
HTML Reporter показывает вам полный отчет о ваших тестах, позволяя фильтровать отчет по браузерам, пройденным тестам, неудачным тестам, пропущенным тестам и нестабильным тестам. По умолчанию HTML отчет открывается автоматически, если некоторые из тестов не прошли, в противном случае вы можете открыть его с помощью следующей команды.
npx playwright show-report
Вы можете фильтровать и искать тесты, а также нажимать на каждый тест, чтобы увидеть ошибки тестов и исследовать каждый шаг теста.