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

У цьому посібнику показано, як зафіксувати базову лінію, прочитати робочі доріжки та вкладену тестову активність, сформулювати гіпотезу та перевірити, чи дійсно зміна покращує набір тестів.


Що записує репортер Perfetto

Репортер записує файл у форматі подій трасування, який підтримують інтерфейс Perfetto та 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 runner, початкове спостереження могло бути сплутане навантаженням інфраструктури.


Безпека та оперативні заходи

Звіти Perfetto можуть містити операційно чутливі докази, такі як імена тестів, розташування джерел, параметри кроків, помилки, стандартний вивід даних та шляхи вкладень.

Застосуйте такі контролі:

Шлях вкладення у звіті — це не сам файл, але посиланий скріншот, журнал, відео чи інший файл можуть містити додаткові конфіденційні дані.


Список перевірки якості

Перед тим, як приймати оптимізацію тестового набору, переконайтеся:


Висновок

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

Найцінніша практика — це не просто створення сліду. Це використання контрольованих вимірювань до і після, розділення затримки застосунку від накладних витрат і планування, збереження коректності при оптимізації часу виконання.

Джерела