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, холодные кэши, внешние сервисы, повторные проверки и тестовые данные могут изменить результат.
Используйте контролируемую базовую линию:
- Закрепите версию Playwright, проект браузера, количество работников, выбор тестов и тип CI runner.
- Запускайте один и тот же комплекс несколько раз при аналогичных условиях.
- Сохраните отчёт Perfetto, HTML-отчёт, общее время работы на стене и запустите метаданные.
- Рекордные повторения, отказы, инциденты внешнего обслуживания и необычная нагрузка на бегун.
- Сравнивайте распределения или повторяющиеся наблюдения, а не только один самый быстрый забег.
Дайте артефактам однозначные названия в 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и документируют вложенные крючки, приспособления и шаги в хронологии. Спросите:
- Подготовка или разборка занимает большую часть теста?
- Стоило ли светильник с рабочим прицелом один раз дорогим или пробный светильник повторяется?
- Называемый
test.step()постоянно медленный? - Ошибка или повторная попытка объясняет более длинное окно выполнения?
Имена и местоположения источников являются доказательством навигации. Они не являются доказательством причинно-следственной связи.
3. Использовать аргументы trace-event
Детали, прикреплённые к срезу, могут указывать на исходную строку и включать теги, аннотации, ошибки, выводы, параметры шагов и пути вложения. Используйте их для связи наблюдения временной шкалы с соответствующим кодом и запуска доказательств.
Избегайте размещения секретов или личных данных в заголовки тестов, аннотации, параметры шагов, логи или имена файлов вложений. Эти значения могут стать частью отчета.
4. Используйте водопад длительности HTML как второй способ
Playwright 1.63 также добавляет водопад длительности рядом с этапами тестирования в HTML-отчёте. Это полезно для быстрого определения того, какие шаги доминируют в конкретном тесте.
Рассматривайте HTML-водопад и таймлайн Perfetto как дополняющие отчёты из одного запуска. Официальная документация не описывает автоматическую перекрестную навигацию между ними, поэтому сравнивайте их вручную по тесту и названию шага.
Три класса задержек
Полезное исследование определяет, куда уходит время.
Задержка приложений или сервисов
Возможные сигналы:
- шаг ждёт состояния UI или ответа API;
- Тот же механизм происходит медленно за пределами тестового бегуна;
- Данные на сервере или сети показывают совпадающую задержку.
Возможные следующие проверки включают тайминг сервера, длительность запроса, здоровье зависимости и контролируемое сравнение.
Накладные расходы тестового дизайна
Возможные сигналы:
- повторную аутентификацию или создание данных в тестовом фикстуре;
- дорогая установка или разборка по каждому тесту;
- петли опроса с чрезмерно широкими интервалами или тайм-аутами;
- Дублированная подготовка, скрытая внутри помощников.
Оптимизируйте только после подтверждения требований изоляции и безопасности данных. Перенос настройки в состояние beforeAll или совместное использование может ускорить тестирование, но также создать связь и зависимость от порядка.
Планирование или дисбаланс воркеров
Возможные сигналы:
- Одна полоса для рабочих занята, пока другие не работают;
- большой тестовый файл не может быть эффективно распространен;
- Последовательная конфигурация, блокировки или зависимости намеренно ограничивают параллельность.
Увеличение workers не является автоматическим решением. Оно может увеличить конкуренцию, сбой по лимиту скорости, использование ресурсов или нестабильность.
Безопасный рабочий процесс до и после
Используйте этот цикл для каждой предлагаемой оптимизации:
- Наблюдать — определить повторяющийся паттерн временной линии, а не изолированный всплеск.
- Сформировать одну гипотезу — например, «настройка аутентификации повторяется за каждый тест».
- Изменить одну переменную — сохранить стабильность браузера, количества работников, раннера и выбора тестов.
- Повторяйте измерения — соберите несколько аналогичных загонов.
- Проверяйте качество, а не только скорость — проверяйте процент сдачи, повторные попытки, изоляцию, логи и очистку.
- Сохранить или отменить — принимать изменение только тогда, когда доказательства повторяются и нет регрессии качества.
Более короткий срез и меньшее общее время поддерживают гипотезу. Они всё ещё не доказывают, что изменение поможет каждой среде или всем комплексам.
Пример исследования
Предположим, что одна рабочая полоса неоднократно заканчивает намного позже остальных.
Хронология показывает, что большой файл содержит несколько длинных тестов. Их вложенные фикстуры необычно дорогие, а шаги применения имеют одинаковую длительность для всех запусков.
Разумный эксперимент — разделить этот файл на меньшие независимые файлы или включить параллельное выполнение для безопасной группы. Затем повторить тот же набор с тем же рабочим числом.
Изменение будет успешным только если:
- время настенных часов улучшается при повторяющихся заездах;
- Показатели проходов и повторных попыток не регрессуют;
- Тесты остаются изолированными;
- Общие аккаунты, данные и внешние сервисы не перегружены.
Если улучшение исчезнет на более загруженном CI-бегу, первоначальное наблюдение могло быть сбянтено нагрузкой на инфраструктуру.
Меры предосторожности по безопасности и эксплуатации
Отчёты Perfetto могут содержать операционно чувствительные данные, такие как имена тестов, расположение источников, параметры шагов, ошибки, стандартный вывод и пути вложения.
Примените следующие элементы контроля:
- ограничить доступ к артефактам;
- Держать время удержания максимально коротко, насколько позволяет расследование;
- не раскрывайте отчёты в публичных строительных артефактах;
- редактировать секреты и личные данные на источнике логирования;
- отдельно проверьте имена и содержимое приложений;
- использовать сжатый выход для больших пробегов;
- документируйте версию Playwright, используемую для генерации каждой базовой линии.
Путь вложения в отчёте — это не само вложение, но ссылка на скриншот, журнал, видео или другой файл может содержать дополнительные чувствительные данные.
Контрольный список QA
Перед принятием оптимизации тестового комплекса убедитесь:
- [ ] Записаны версия Playwrightа, проект браузера, рабочие и тип бегуна.
- [ ] Базовая линия использует повторяющиеся сопоставимые очки.
- [ ] Артефакты Perfetto и HTML поступают из одного и того же запуска.
- [ ] Наблюдение связано с конкретным рабочим, тестом, крюком, креплением или шагом.
- [ ] Объяснение считается гипотезой до проверки.
- [ ] Во время эксперимента меняется только одна значимая переменная.
- [ ] Проверяются процент сдачи, повторные попытки, нестабильность, изоляция и очистка.
- [ ] Общие системы не перегружены из-за большей параллельности.
- [ ] Следовые артефакты не раскрывают секреты или личные данные.
- [ ] Результат повторяется и документируется.
Заключение
Репортер Perfetto предоставляет командам Playwright временную шкалу самого тест‑раннера: рабочие дорожки, тестовые срезы и вложенные хуки, фикстуры и шаги. Водопад длительности HTML добавляет удобный вид на уровне шагов.
Самая ценная практика — это не просто создание трассы. Это использование контролируемых измерений до и после, разделение задержки приложений от накладных расходов и планирования, а также сохранение корректности при оптимизации времени выполнения.
Источники
- Playwright release notes, version 1.63: Playwright 1.63 release notes
- Playwright reporters, Perfetto reporter: Playwright Perfetto reporter documentation
Оставить комментарий
Поделитесь своим мнением о статье. Регистрация не требуется.
Комментарии
Загрузка комментариев…