Playwright 1.63 fügte zwei nützliche Ansichten für die leistungsorientierte Analyse der Testsuite hinzu: einen integrierten Perfetto‑Reporter und einen Dauer‑Wasserfall im HTML‑Bericht. Sie diagnostizieren die Ursachen nicht automatisch, erleichtern aber die Überprüfung von Timing‑ und Zeitnachweisen.

Dieser Leitfaden zeigt, wie man eine Baseline erfasst, Worker‑Lanes und verschachtelte Testaktivitäten liest, eine Hypothese bildet und überprüft, ob eine Änderung die Suite tatsächlich verbessert.


Was der Perfetto‑Reporter festhält

Der Reporter schreibt eine Datei im Trace Event Format, das von Perfetto UI und chrome://tracing verwendet wird. Playwright rendert den Lauf als Zeitleiste mit einer Spur pro Arbeiter.

Jeder Test wird als Slice dargestellt. Seine Haken, Fixturen und test.step() Schritte erscheinen als verschachtelte Slices. Trace-Event-Argumente können Folgendes umfassen:

Dies ist Test-Instrumentierung, keine Browser-Leistungstelemetrie. Sie ersetzt weder die Messung von Core Web Vitals, noch ein Browser-Leistungsprofil, Backend-Observabilität oder Infrastrukturüberwachung.


Aktiviere den Reporter

Der kleinste Befehl lautet:

npx playwright test --reporter=perfetto

Standardmäßig schreibt Playwright den Bericht an:

test-results/perfetto.json

Für große Suiten ist eine gzip-komprimierte Ausgabe in der Regel praktischer. Sowohl die Perfetto-Benutzeroberfläche als auch chrome://tracing akzeptieren es:

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

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

Sie können die Ausgabe auch über PLAYWRIGHT_PERFETTO_OUTPUT_DIR, PLAYWRIGHT_PERFETTO_OUTPUT_NAME oder PLAYWRIGHT_PERFETTO_OUTPUT_FILE konfigurieren.

Ein wichtiges Kommandozeilen-Detail: --reporter ersetzt die konfigurierten Reporter. Wenn Sie die bestehenden Reporter behalten und Perfetto hinzufügen müssen, bietet Playwright 1.63 auch --add-reporter:

npx playwright test --add-reporter=perfetto

Erstelle eine vertrauenswürdige Basis

Ein einzelner Durchlauf kann irreführend sein. Gemeinsame CI-Kapazität, Cold Caches, externe Dienste, Wiederholungen und Testdaten können das Ergebnis alle verändern.

Verwenden Sie eine kontrollierte Basislinie:

  1. Pinne die Playwright-Version, das Browserprojekt, die Anzahl der Arbeiter, die Testauswahl und den CI-Runner-Typ.
  2. Führe dieselbe Suite mehrmals unter vergleichbaren Bedingungen durch.
  3. Speichere den Perfetto-Bericht, den HTML-Bericht, die gesamte Wanduhrzeit und führe Metadaten aus.
  4. Erfassen Sie Wiederholungen, Ausfälle, Vorfälle bei externem Service und ungewöhnliche Belastung der Läufer.
  5. Vergleichen Sie Verteilungen oder wiederholte Beobachtungen, nicht nur einen schnellsten Durchlauf.

Geben Sie den Artefakten in CI eindeutige Bezeichnungen, zum Beispiel:

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

Standardmäßig werden große Berichte nicht in das Quellrepository eingetragen. Ein geschützter CI-Artefaktspeicher mit kurzer Speicherdauer ist in der Regel sicherer und leichter zu verwalten.


Lesen Sie die Perfetto‑Zeitleiste

Öffnen Sie ui.perfetto.dev, wählen Sie Trace-Datei öffnen und wählen Sie den JSON oder JSON. GZ-Bericht. Für sensible Projekte folgen Sie vor dem Laden eines Artefakts in ein Tool die Richtlinien Ihrer Organisation.

1. Beginnen Sie mit Worker‑Lanes

Betrachten Sie, wie Arbeit verteilt ist:

Eine Long Lane beweist nicht, dass der Worker selbst defekt ist. Sie zeigt Ihnen, wo Sie Testverteilung, Seriellgruppen, Sperren, Abhängigkeiten und ungleiche Dateigrößen untersuchen können.

2. Inspizieren Sie lange Testabschnitte

Zoomen Sie in die längsten Tests und untersuchen Sie deren verschachtelte Schnitte. Der Playwright dokumentiert verschachtelte Haken, Fixturen und Schritte in der Zeitleiste. Fragen Sie:

Namen und Quellenorte sind Belege für die Navigation. Sie sind kein Beweis für Kausalität.

3. Verwendung von Trace‑Event‑Argumenten

Die an einen Slice angehängten Details können auf seine Quellzeile verweisen und Tags, Annotationen, Fehler, Ausgaben, Schrittparameter und Anhängungspfade enthalten. Verwenden Sie sie, um eine Zeitleiste-Beobachtung mit dem relevanten Code zu verknüpfen und die Beweise auszuführen.

Vermeiden Sie es, Geheimnisse oder persönliche Daten in Testtitel, Anmerkungen, Schrittparameter, Protokolle oder Anhänge-Dateinamen einzufügen. Diese Werte können Teil des Berichts werden.

4. Verwenden Sie den HTML‑Dauer‑Wasserfall als zweite Ansicht

Playwright 1.63 fügt außerdem neben Testschritten im HTML-Bericht einen Dauer-Wasserfall hinzu. Er ist nützlich, um schnell zu sehen, welche Schritte einen bestimmten Test dominieren.

Behandle den HTML-Wasserfall und die Perfetto-Timeline als komplementäre Berichte aus demselben Durchlauf. Die offizielle Dokumentation beschreibt keine automatische Crossnavigation zwischen ihnen, daher vergleiche sie sie manuell nach Test und Schrittname.


Trennen Sie drei Verzögerungsklassen

Eine nützliche Untersuchung unterscheidet, wo die Zeit verbracht wird.

Anwendungs‑ oder Dienstlatenz

Mögliche Signale:

Mögliche nächste Prüfungen umfassen Server-Timing, Anfragedauer, Abhängigkeitszustand und einen kontrollierten Mock-Comparison.

Test‑Design‑Overhead

Mögliche Signale:

Optimieren Sie nur nach Bestätigung von Isolations- und Datensicherheitsanforderungen. Das Verschieben der Einrichtung in den beforeAll- oder geteilten Zustand kann Tests beschleunigen, aber auch Kopplung und Ordnungsabhängigkeit schaffen.

Planungs‑ oder Worker‑Ungleichgewicht

Mögliche Signale:

Eine Erhöhung workers ist keine automatische Lösung. Sie kann Konkurrenz, Ausfallrate bei Ratenbegrenzungen, Ressourcenverbrauch oder Unzuverlässigkeit erhöhen.


Ein sicherer Vorher‑Nachher‑Arbeitsablauf

Verwenden Sie diese Schleife für jede vorgeschlagene Optimierung:

  1. Beobachten – identifiziere ein wiederholtes Zeitlinienmuster, nicht einen isolierten Spitzensprung.
  2. Form einer Hypothese – zum Beispiel: "Die Authentifizierung wird pro Test wiederholt."
  3. Ändere eine Variable – halte Browser, Worker Count, Runner und Testauswahl stabil.
  4. Wiederhole die Messungen – sammle mehrere vergleichbare Nachläufe.
  5. Überprüfen Sie die Qualität, nicht nur die Geschwindigkeit — überprüfen Sie die Bestehensrate, Wiederholungen, Isolation, Protokolle und Aufräumen.
  6. Behalten oder rückgängig machen — Akzeptiere die Änderung nur, wenn die Beweise wiederholbar sind und keine Qualitätsrückentwicklung auftritt.

Ein kürzerer Schnitt und eine kürzere Gesamtzeit stützen die Hypothese. Sie beweisen immer noch nicht, dass die Änderung jeder Umgebung oder jeder Suite hilft.


Beispieluntersuchung

Angenommen, eine Arbeiterbahn endet wiederholt viel später als die anderen.

Die Zeitleiste zeigt, dass eine große Datei mehrere lange Tests enthält. Ihre verschachtelten Fixtures sind nicht ungewöhnlich teuer, und die Anwendungsschritte haben eine ähnliche Dauer über verschiedene Durchläufe.

Ein vernünftiges Experiment ist, diese Datei in kleinere, unabhängige Dateien aufzuteilen oder die parallele Ausführung für eine sichere Gruppe zu aktivieren. Dann wiederholt man die gleiche Suite mit derselben Anzahl an Arbeitern.

Die Änderung ist nur erfolgreich, wenn:

Wenn die Verbesserung bei einem stärker frequentierten CI-Runner verschwindet, könnte die ursprüngliche Beobachtung durch die Infrastrukturbelastung überlagert worden sein.


Sicherheits‑ und betriebliche Vorsichtsmaßnahmen

Perfetto-Berichte können betriebssensitive Hinweise wie Testnamen, Quellpositionen, Schrittparameter, Fehler, Standardausgaben und Anbindungspfade enthalten.

Wenden Sie diese Steuerungen an:

Ein Anhangpfad im Bericht ist nicht der Anhang selbst, aber der referenzierte Screenshot, das Protokoll, das Video oder eine andere Datei kann zusätzliche sensible Daten enthalten.


QA‑Checkliste

Bevor Sie eine Testsuite-Optimierung akzeptieren, bestätigen Sie:


Fazit

Der Perfetto‑Reporter gibt den Playwright‑Teams eine Zeitleiste des Test‑Runners selbst: Worker‑Lanes, Testabschnitte sowie verschachtelte Hooks, Fixtures und Schritte. Der HTML‑Dauer‑Wasserfall fügt eine praktische Ansicht auf Stufenebene hinzu.

Die wertvollste Praxis ist nicht einfach das Erstellen eines Traces. Sie nutzt kontrollierte Vorher‑Nachher‑Messungen, trennt Anwendungslatenz von Test‑Overhead und Scheduling und erhält die Korrektheit bei gleichzeitiger Optimierung der Ausführungszeit.

Quellen