Debug-Modus

Der Debug-Modus des Runners bietet erweiterte Werkzeuge zur Fehleranalyse: Playwright Trace, Videoaufzeichnung und sichtbare Browserausführung.

Headed-Modus (Observer)

Im Headed-Modus öffnet der Runner ein sichtbares Browserfenster. Sie können die Testausführung live beobachten:

• Seitennavigation und DOM-Änderungen in Echtzeit verfolgen
• Visuell prüfen, ob Elemente korrekt geladen werden
• Timing-Probleme erkennen, die im Headless-Modus unsichtbar bleiben

TIP

Aktivieren Sie den Headed-Modus über den Toggle Stealth / Observer in der Runner-Oberfläche. Im chirurgischen Modus mit einem einzelnen Test ist dies besonders nützlich.

Playwright Trace

Der Trace-Viewer ist Playwrights mächtigstes Debug-Werkzeug. Bei fehlgeschlagenen Tests erzeugt xyva automatisch eine Trace-Datei, die folgende Informationen enthält:

• Aktionsprotokoll — jede Aktion (Klick, Eingabe, Navigation) mit Zeitstempel
• DOM-Snapshots — der Zustand der Seite vor und nach jeder Aktion
• Netzwerk-Log — alle HTTP-Anfragen und -Antworten
• Konsolen-Ausgabe — Browser-Logs und Fehlermeldungen

Trace öffnen

Nach einem fehlgeschlagenen Lauf erscheint in der Konsole ein Link zum Trace. Ein Klick öffnet den Playwright Trace Viewer direkt in xyva.

INFO

Traces werden standardmäßig nur bei Fehlern erzeugt. Über die Runner-Einstellungen können Sie Traces auch für erfolgreiche Tests aktivieren, was bei der Analyse von Flaky Tests hilfreich ist.

Videoaufzeichnung

Zusätzlich zum Trace kann der Runner ein Video der Testausführung aufnehmen:

• Automatisch bei Fehler — Videos werden nur für fehlgeschlagene Tests gespeichert
• Immer aufnehmen — für vollständige visuelle Nachverfolgung
• Wiedergabe — direkt in xyva oder als .webm-Datei exportierbar

Screenshots

Bei Assertion-Fehlern erstellt der Runner automatisch einen Screenshot des aktuellen Seitenzustands. Dieser wird:

• Inline in der Konsole als Vorschau angezeigt
• Im Testbericht als Anhang gespeichert
• Mit dem Trace verknüpft für kontextbezogene Analyse

Retry-Strategie

Für instabile Umgebungen bietet der Runner konfigurierbare Retries:

Einstellung	Beschreibung
Retries	Anzahl der Wiederholungsversuche (0–3)
Nur bei Fehler	Nur fehlgeschlagene Tests werden wiederholt
Trace bei Retry	Bei jedem Wiederholungsversuch wird ein Trace erzeugt

WARNING

Übermäßige Retries können echte Fehler maskieren. Nutzen Sie das Flaky-Test-Labor, um die Ursache instabiler Tests zu finden, anstatt sie durch Wiederholung zu überdecken.

Weiterführende Seiten

• Konsole & Logs — Live-Streaming und Fehler-Highlighting
• Flaky-Test-Erkennung — Instabile Tests systematisch analysieren