Инструменты отладки Playwright

В этой главе представлены три основных инструмента отладки Playwright: UI Mode, Trace Viewer и режим Debug командной строки.


Полное введение в UI Mode

UI Mode — это встроенный графический интерфейс тестирования Playwright, обеспечивающийвозможность изучения, запуска и отладки тестов в одном месте..

Запуск UI Mode

npx playwright test --ui

Просмотр списка тестов

После запуска на левой боковой панели отображаются все файлы тестов.

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

Режим наблюдения

После нажатия кнопки Watch Playwright отслеживает изменения файлов и автоматически перезапускает затронутые тесты, как только тестовый код или исходный код обновляется.

Просмотр временной шкалы

После выполнения теста в верхней части появляется временная шкала, на которой навигация и действия отмечаются разными цветами.

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

Снимок DOM

При щелчке по шагу на временной шкале справа отображается снимок DOM этого момента.

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

Фильтрация тестов

Режим UI поддерживает несколько методов фильтрации:

  • Поиск по имени теста, чтобы
  • нажмите
    @tag
    filter
  • Фильтр по проекту
  • Фильтр по статусу: пройден, не пройден, пропущен

Углубленная отладка с помощью Trace Viewer

Trace Viewer — это инструмент записи и воспроизведения Playwright, позволяющий вампросматривать каждый шаг теста так же, как при отладке записи.。

Настройка сбора Trace

Пример

// Путь к файлу: playwright.config.ts
export default defineConfig({
  использовать: {
    // Собирать Trace только при повторной попытке после сбоя
    trace: 'on-first-retry',

    // Возможные значения:
    // 'off' —— Не собирать
    // 'on' —— Собирать каждый раз
    // 'on-first-retry' —— Собирать только при первой повторной попытке (рекомендуется)
    // 'retain-on-failure' —— Сохранять Trace только при сбое
  },
});

Открытие Trace

# 本地打开
npx playwright show-trace path/to/trace.zip

Вы также можете загрузить его наtrace.playwright.devдля онлайн-просмотра.

Информация, содержащаяся в трассировке

СодержаниеОписание
Снимок DOMПолные снимки DOM страницы до и после выполнения каждого шага
Сетевые запросыВсе HTTP-запросы и ответы (URL, код состояния, заголовок, тело)
Журналы консолиВсе сообщения, выводимые консолью браузера
СкриншотыСнимки экрана страницы для каждого шага
Журнал действийАргументы вызова и время выполнения всех действий Playwright
Исходный кодМестоположение исходного кода теста, соответствующее каждому действию

Использование трассировки для поиска сбоев

Найдите шаг, на котором произошла ошибка, на временной шкале Trace Viewer, проверьте состояние DOM и сетевые запросы страницы до и после этого шага и определите причину сбоя.

Trace — самый мощный инструмент отладки. Когда тест падает в CI, но вы не можете воспроизвести его локально, можно скачать файл Trace, сгенерированный CI, чтобы проанализировать причину сбоя офлайн.


Режим --debug и page.pause()

Режим командной строки --debug

npx playwright test --debug

Возможности:

  • Автоматически открывает окно Playwright Inspector
  • Выполняйте операции шаг за шагом
  • Отладка в DevTools браузера
  • Используйте
    F10
    (Step Over) и
    F11
    (Step Into) для управления выполнением

page.pause() приостанавливает выполнение

Пример

// Установите точку останова в коде
test('тест для отладки', async ({ page }) => {
  await page.goto('https://www.example.com/');

  // Приостановить выполнение и открыть Инспектор
  await page.pause();

  // В Инспекторе можно пошагово выполнять последующие действия
  await page.getByText('EXAMPLE Tutorial').click();
});

После использованияpage.pause()Чтобы запустить тест, Playwright автоматически откроет окно Инспектора, позволяя пошагово проверять состояние страницы.


Выбор среди трёх методов отладки

МетодПрименимый сценарий
Режим UIЕжедневная разработка, просмотр списка тестов, быстрая проверка статуса теста
Просмотр трассировокПоиск сбоев CI, анализ каждого шага сложных тестов
--debug / page.pause()Разработка новых тестов, углублённая отладка конкретных шагов
Другие расширения