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:
- Quellenorte;
- Schrittparameter;
- Tags und Anmerkungen;
- Fehler;
- Standardausgabe und Standardfehler;
- Pfade zu Anhängedateien.
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=perfettoStandardmäßig schreibt Playwright den Bericht an:
test-results/perfetto.jsonFü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=perfettoErstelle 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:
- Pinne die Playwright-Version, das Browserprojekt, die Anzahl der Arbeiter, die Testauswahl und den CI-Runner-Typ.
- Führe dieselbe Suite mehrmals unter vergleichbaren Bedingungen durch.
- Speichere den Perfetto-Bericht, den HTML-Bericht, die gesamte Wanduhrzeit und führe Metadaten aus.
- Erfassen Sie Wiederholungen, Ausfälle, Vorfälle bei externem Service und ungewöhnliche Belastung der Läufer.
- 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.gzStandardmäß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:
- Sind mehrere Fahrspuren gleichzeitig befahren?
- Macht ein Arbeiter noch lange weiter, nachdem die anderen fertig sind?
- Gibt es große Leerlauflücken?
- Erstellen Tests, die seriell ausgeführt werden müssen, eine sichtbare Warteschlange?
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:
- Nimmt Setup oder Teardown den Großteil des Tests in Anspruch?
- Ist eine Werker-Scope-Leuchte früher teuer, oder wird eine Test-Scope-Armatur wiederholt?
- Ist ein benannter
test.step()durchgehend langsam? - Erklärt ein Fehler oder ein erneuter Versuch das längere Ausführungsfenster?
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:
- ein Schritt wartet auf einen UI-Zustand oder eine API-Antwort;
- die gleiche Bewegung ist außerhalb des Testläufers langsam;
- Backend- oder Netzwerknachweise zeigen entsprechende Latenz.
Mögliche nächste Prüfungen umfassen Server-Timing, Anfragedauer, Abhängigkeitszustand und einen kontrollierten Mock-Comparison.
Test‑Design‑Overhead
Mögliche Signale:
- wiederholte Authentifizierung oder Datenerstellung in einer testbezogenen Fixture;
- teure Einrichtung oder Zerlegung bei jedem Test;
- Umfrageschleifen mit übermäßig langen Intervallen oder Auszeiten;
- doppelte Vorbereitung versteckt in Helfern.
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 Arbeiterstraße bleibt besetzt, während andere ungenutzt sind;
- Eine große Testdatei kann nicht effizient verteilt werden;
- Serielle Konfiguration, Sperren oder Abhängigkeiten schränken absichtlich die Nebenläufigkeit ein.
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:
- Beobachten – identifiziere ein wiederholtes Zeitlinienmuster, nicht einen isolierten Spitzensprung.
- Form einer Hypothese – zum Beispiel: "Die Authentifizierung wird pro Test wiederholt."
- Ändere eine Variable – halte Browser, Worker Count, Runner und Testauswahl stabil.
- Wiederhole die Messungen – sammle mehrere vergleichbare Nachläufe.
- Überprüfen Sie die Qualität, nicht nur die Geschwindigkeit — überprüfen Sie die Bestehensrate, Wiederholungen, Isolation, Protokolle und Aufräumen.
- 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:
- Die Wanduhrzeit verbessert sich bei wiederholten Läufen;
- Die Bestehens- und Wiederholungsraten gehen nicht zurück;
- Tests bleiben isoliert;
- Gemeinsame Konten, Daten und externe Dienste sind nicht überlastet.
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:
- den Zugang zu Artefakten einschränken;
- Halte die Erinnerung so kurz, wie es die Untersuchung erlaubt;
- Berichte öffentlich nicht offenlegen; Bau-Artefakte;
- Geheimnisse und persönliche Daten an ihrer Protokollquelle schwärzen;
- überprüfen Anhängenamen und Inhalte separat;
- Verwenden Sie komprimierte Ausgaben für große Laufzeiten;
- Dokumentiere die Playwright-Version, die zur Erstellung jeder Basislinie verwendet wird.
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:
- [ ] Playwright-Version, Browserprojekt, Worker-Anzahl und Runner-Typ werden dokumentiert.
- [ ] Die Grundlinie verwendet wiederholte, vergleichbare Läufe.
- [ ] Perfetto- und HTML-Artefakte stammen aus demselben Runset.
- [ ] Die Beobachtung ist mit einem bestimmten Arbeiter, Test, Haken, Vorrichtung oder Schritt verknüpft.
- [ ] Die Erklärung wird als Hypothese bezeichnet, bis sie bestätigt ist.
- [ ] Nur eine bedeutungsvolle Variable ändert sich während des Experiments.
- [ ] Bestehensrate, Wiederholungen, Unzuverlässigkeit, Isolation und Aufräumen werden überprüft.
- [ ] Gemeinsame Systeme werden durch höhere Nebenwahl nicht überlastet.
- [ ] Spurenartefakte legen keine Geheimnisse oder persönliche Daten preis.
- [ ] Das Ergebnis ist wiederholbar und dokumentiert.
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
- Playwright release notes, version 1.63: Playwright 1.63 release notes
- Playwright reporters, Perfetto reporter: Playwright Perfetto reporter documentation
Kommentar hinterlassen
Teilen Sie Ihre Gedanken zum Artikel. Kein Konto erforderlich.
Kommentare
Kommentare werden geladen…