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, холодні кеші, зовнішні сервіси, повторні спроби та тестові дані можуть змінити результат.
Використовуйте контрольовану базову лінію:
- Закріпіть версію 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 як додаткові звіти з одного запуску. Офіційна документація не описує автоматичну перехресну навігацію між ними, тому порівнюйте їх вручну за тестом і назвою кроку.
Розділіть три класи затримки
Корисне дослідження розрізняє, куди витрачається час.
Затримка додатку або сервісу
Можливі сигнали:
- крок чекає на стан інтерфейсу або відповідь API;
- Та сама дія повільна поза тестовим бігуном;
- Дані бекенду або мережі показують відповідність затримки.
Можливі наступні перевірки включають таймінг сервера, тривалість запиту, стан залежності та контрольоване порівняння.
Накладні витрати на тестове проєктування
Можливі сигнали:
- повторну автентифікацію або створення даних у тестовому пристрої;
- дороге налаштування або розбирання навколо кожного тесту;
- петлі опитування з надто широкими інтервалами або тайм-аутами;
- Дубльована підготовка, прихована всередині помічників.
Оптимізуйте лише після підтвердження вимог ізоляції та безпеки даних. Перенесення налаштування у стан beforeAll або спільне використання може прискорити тести, а також створити залежність від зв'язку та порядку.
Розклад або дисбаланс робітників
Можливі сигнали:
- одна смуга для працівників зайнята, поки інші не працюють;
- великий тестовий файл не може бути ефективно розповсюджений;
- Послідовна конфігурація, блокування або залежності навмисно обмежують паралельність.
Збільшення workers не є автоматичним рішенням. Воно може збільшити конкуренцію, збоїв обмеження швидкості, використання ресурсів або нестабільність.
Безпечний робочий процес до і після
Використовуйте цей цикл для кожної запропонованої оптимізації:
- Спостерігати — визначити повторюваний часовий патерн, а не ізольований сплеск.
- Сформуйте одну гіпотезу — наприклад, «налаштування автентифікації повторюється для кожного тесту».
- Змінити одну змінну — зберегти стабільність браузера, підрахунку працівників, бігу та вибору тесту.
- Повторіть вимірювання — зберіть кілька порівнянних післязапусків.
- Перевіряйте якість, а не лише швидкість — перевіряйте відсоток проходжень, повторні спроби, ізоляцію, журнали та прибирання.
- Залишити або повернути назад — приймати зміну лише тоді, коли докази повторювані і не з'являється регресії якості.
Коротший зріз і менший загальний час підтверджують цю гіпотезу. Вони все одно не доводять, що зміна допоможе кожному середовищу чи кожному комплексу.
Приклад дослідження
Припустимо, що одна робітнича смуга неодноразово закінчується значно пізніше за інші.
Хронологія показує, що великий файл містить кілька довгих тестів. Їхні вкладені фітюри не надто дорогі, а етапи застосування мають схожу тривалість між запусками.
Розумним експериментом є розділити цей файл на менші незалежні файли або увімкнути паралельне виконання для безпечної групи. Потім повторити той самий пакет із тією ж кількістю працівників.
Зміна є успішною лише якщо:
- Час настінного годинника покращується при повторних заїздах;
- Показники проходження та повторних спроб не регресують;
- Тести залишаються ізольованими;
- Спільні облікові записи, дані та зовнішні сервіси не перевантажені.
Якщо покращення зникне на більш завантаженому CI runner, початкове спостереження могло бути сплутане навантаженням інфраструктури.
Безпека та оперативні заходи
Звіти Perfetto можуть містити операційно чутливі докази, такі як імена тестів, розташування джерел, параметри кроків, помилки, стандартний вивід даних та шляхи вкладень.
Застосуйте такі контролі:
- обмежити доступ до артефактів;
- тримати утримання настільки коротко, наскільки дозволяє розслідування;
- не розкривати звіти у публічних будівельних артефактах;
- редагувати секрети та особисті дані на джерелі логування;
- окремо переглядайте назви та вміст вкладень;
- використовувати стиснений вихід для великих серій;
- документувати версію Playwrightа, яка використовується для генерації кожної базової лінії.
Шлях вкладення у звіті — це не сам файл, але посиланий скріншот, журнал, відео чи інший файл можуть містити додаткові конфіденційні дані.
Список перевірки якості
Перед тим, як приймати оптимізацію тестового набору, переконайтеся:
- [ ] Записуються версія 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
Залишити коментар
Поділіться думкою про статтю. Реєстрація не потрібна.
Коментарі
Завантаження коментарів…