Playwright 1.63 добавил два полезных представления для анализа тестового набора с учётом производительности: встроенный репортер Perfetto и водопад длительности в HTML‑отчёте. Они не диагностируют коренные причины автоматически, но упрощают проверку расписания и тайминговых доказательств.

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


Что записывает репортер Perfetto

Репортер записывает файл в формате Trace Event, используемом в Perfetto UI и chrome://tracing. Playwright отображает пробег в виде таймлайна с одной полосой на работника.

Каждый тест представлен в виде среза. Его крючки, фикстуры и test.step() шаги представлены как вложенные срезы. Аргументы трассировки могут включать:

Это тестовая инструментация, а не телеметрия производительности браузера. Она не заменяет измерение Core Web Vitals, профиль производительности браузера, наблюдаемость бэкенда или мониторинг инфраструктуры.


Включить репортер

Самая маленькая команда — следующее:

npx playwright test --reporter=perfetto

По умолчанию Playwright пишет отчёт на следующий адрес:

test-results/perfetto.json

Для больших наборов обычно более практична сжатая через gzip выход. И Perfetto UI, и chrome://tracing принимают его:

// playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  reporter: [
    ['list'],
    ['html', { open: 'never' }],
    ['perfetto', { outputFile: 'test-results/perfetto.json.gz' }],
  ],
});

Вы также можете настроить выход через PLAYWRIGHT_PERFETTO_OUTPUT_DIR, PLAYWRIGHT_PERFETTO_OUTPUT_NAME или PLAYWRIGHT_PERFETTO_OUTPUT_FILE.

Одна важная деталь командной строки: --reporter заменяет настроенные репортеры. Если нужно сохранить существующие репортеры и добавить Perfetto, Playwright 1.63 также предоставляет --add-reporter:

npx playwright test --add-reporter=perfetto

Постройте надёжную базу

Один запуск может вводить в заблуждение. Общая ёмкость CI, холодные кэши, внешние сервисы, повторные проверки и тестовые данные могут изменить результат.

Используйте контролируемую базовую линию:

  1. Закрепите версию Playwright, проект браузера, количество работников, выбор тестов и тип CI runner.
  2. Запускайте один и тот же комплекс несколько раз при аналогичных условиях.
  3. Сохраните отчёт Perfetto, HTML-отчёт, общее время работы на стене и запустите метаданные.
  4. Рекордные повторения, отказы, инциденты внешнего обслуживания и необычная нагрузка на бегун.
  5. Сравнивайте распределения или повторяющиеся наблюдения, а не только один самый быстрый забег.

Дайте артефактам однозначные названия в CI, например:

perfetto-before-2026-10-27.json.gz
perfetto-after-2026-10-27.json.gz

По умолчанию не фиксируйте большие отчёты в исходный репозиторий. Защищённое хранилище артефактов CI с коротким периодом хранения обычно безопаснее и проще в управлении.


Просмотрите таймлайн Perfetto

Откройте ui.perfetto.dev, выберите Открыть файл трассировки и выберите отчет JSON или JSON. GZ. Для чувствительных проектов следуйте политике вашей организации перед загрузкой артефакта в любой инструмент.

1. Начните с рабочих дорожек

Посмотрите, как распределяется работа:

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

2. Осмотрите длинные тестовые срезы

Увеличите масштаб самых длинных тестов и изучите их вложенные срезы. Playwrightи документируют вложенные крючки, приспособления и шаги в хронологии. Спросите:

Имена и местоположения источников являются доказательством навигации. Они не являются доказательством причинно-следственной связи.

3. Использовать аргументы trace-event

Детали, прикреплённые к срезу, могут указывать на исходную строку и включать теги, аннотации, ошибки, выводы, параметры шагов и пути вложения. Используйте их для связи наблюдения временной шкалы с соответствующим кодом и запуска доказательств.

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

4. Используйте водопад длительности HTML как второй способ

Playwright 1.63 также добавляет водопад длительности рядом с этапами тестирования в HTML-отчёте. Это полезно для быстрого определения того, какие шаги доминируют в конкретном тесте.

Рассматривайте HTML-водопад и таймлайн Perfetto как дополняющие отчёты из одного запуска. Официальная документация не описывает автоматическую перекрестную навигацию между ними, поэтому сравнивайте их вручную по тесту и названию шага.


Три класса задержек

Полезное исследование определяет, куда уходит время.

Задержка приложений или сервисов

Возможные сигналы:

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

Накладные расходы тестового дизайна

Возможные сигналы:

Оптимизируйте только после подтверждения требований изоляции и безопасности данных. Перенос настройки в состояние beforeAll или совместное использование может ускорить тестирование, но также создать связь и зависимость от порядка.

Планирование или дисбаланс воркеров

Возможные сигналы:

Увеличение workers не является автоматическим решением. Оно может увеличить конкуренцию, сбой по лимиту скорости, использование ресурсов или нестабильность.


Безопасный рабочий процесс до и после

Используйте этот цикл для каждой предлагаемой оптимизации:

  1. Наблюдать — определить повторяющийся паттерн временной линии, а не изолированный всплеск.
  2. Сформировать одну гипотезу — например, «настройка аутентификации повторяется за каждый тест».
  3. Изменить одну переменную — сохранить стабильность браузера, количества работников, раннера и выбора тестов.
  4. Повторяйте измерения — соберите несколько аналогичных загонов.
  5. Проверяйте качество, а не только скорость — проверяйте процент сдачи, повторные попытки, изоляцию, логи и очистку.
  6. Сохранить или отменить — принимать изменение только тогда, когда доказательства повторяются и нет регрессии качества.

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


Пример исследования

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

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

Разумный эксперимент — разделить этот файл на меньшие независимые файлы или включить параллельное выполнение для безопасной группы. Затем повторить тот же набор с тем же рабочим числом.

Изменение будет успешным только если:

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


Меры предосторожности по безопасности и эксплуатации

Отчёты Perfetto могут содержать операционно чувствительные данные, такие как имена тестов, расположение источников, параметры шагов, ошибки, стандартный вывод и пути вложения.

Примените следующие элементы контроля:

Путь вложения в отчёте — это не само вложение, но ссылка на скриншот, журнал, видео или другой файл может содержать дополнительные чувствительные данные.


Контрольный список QA

Перед принятием оптимизации тестового комплекса убедитесь:


Заключение

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

Самая ценная практика — это не просто создание трассы. Это использование контролируемых измерений до и после, разделение задержки приложений от накладных расходов и планирования, а также сохранение корректности при оптимизации времени выполнения.

Источники