Запуск и отладка тестов

Введение​

С помощью Playwright вы можете запустить один тест, набор тестов или все тесты. Тесты могут быть запущены в одном браузере или нескольких браузерах, используя флаг --project. Тесты по умолчанию выполняются параллельно и в бессерверном режиме, то есть окно браузера не будет открываться во время выполнения тестов, а результаты будут отображаться в терминале. Однако вы можете запустить тесты в режиме с открытым браузером, используя аргумент командной строки --headed, или вы можете запустить тесты в режиме UI-режиме, используя флаг --ui. Посмотрите полную трассировку ваших тестов, включая режим наблюдения, отладку путешествия во времени и многое другое.

Вы узнаете

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

Запуск тестов​

Командная строка​

Вы можете запустить свои тесты с помощью команды 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 в имени файла, просто передайте эти ключевые слова в командную строку.

npx playwright test landing login

Чтобы запустить тест со specific названием, используйте флаг -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 Mode, где вы можете легко пройти каждый шаг теста, увидеть логи, ошибки, сетевые запросы, проверить снимок DOM и многое другое. Вы также можете использовать Инспектор Playwright, который позволяет вам переступать через вызовы API Playwright, видеть их отладочные журналы и изучать локаторы.

Отладка тестов в UI-режиме​

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

npx playwright test --ui

Во время отладки вы можете использовать кнопку «Выбрать локатор», чтобы выбрать элемент на странице и увидеть локатор, который Playwright использует для поиска этого элемента. Вы также можете изменить локатор в игровом поле локаторов и увидеть его живое выделение в окне браузера. Используйте кнопку «Скопировать локатор», чтобы скопировать локатор в буфер обмена, а затем вставьте его в свой тест.

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

Отладка тестов с помощью Инспектора Playwright​

Чтобы отладить все тесты, выполните команду тестирования Playwright, после которой следует флаг --debug.

npx playwright test --debug

Эта команда откроет окно браузера и Инспектор Playwright. Вы можете использовать кнопку «Перейти» в верхней части инспектора, чтобы переходить по вашему тесту. Или нажмите кнопку «воспроизвести», чтобы запустить тест от начала до конца. После завершения теста окно браузера закроется.

Чтобы отладить один файл тестов, выполните команду тестирования Playwright с именем файла теста, который вы хотите отладить, после которого следует флаг --debug.

npx playwright test example.spec.ts --debug

Чтобы отладить конкретный тест с строки, где определено test(.., добавьте двоеточие и номер строки в конце имени файла теста, после которого следует флаг --debug.

npx playwright test example.spec.ts:10 --debug

Во время отладки вы можете использовать кнопку «Выбрать локатор», чтобы выбрать элемент на странице и увидеть локатор, который Playwright использует для поиска этого элемента. Вы также можете изменить локатор и увидеть его живое выделение в окне браузера. Используйте кнопку «Скопировать локатор», чтобы скопировать локатор в буфер обмена, а затем вставьте его в свой тест.

Ознакомьтесь с нашим руководством по отладке, чтобы узнать больше об отладке с помощью отладчика VS Code, UI-режима и Инспектора Playwright, а также об отладке с помощью Инструментов разработчика браузера.

Отчеты о тестах​

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

npx playwright show-report

Вы также можете фильтровать и искать тесты, а также нажимать на каждый тест, чтобы увидеть ошибки тестов и изучить каждый шаг теста.

Что дальше​

• Генерация тестов с помощью Codegen
• Просмотр трассировки ваших тестов
• Изучение всех функций UI-режима
• Запуск тестов на CI с GitHub Actions