Was ist Cypress Test Replay?

Cypress Test Replay ist eine Funktion von Cypress Cloud, die fehlgeschlagene Tests aus der CI Pipeline im Browser nachspielt. Du siehst DOM, Netzwerk Requests, Konsole und jeden Cypress Befehl genau so, wie sie im CI Lauf passiert sind.

Statt eines Videos bekommst du eine echte Aufzeichnung der Anwendung. Du springst zu jedem Befehl, inspizierst Elemente und liest Requests und Responses. Laut Cypress Doku braucht Test Replay Cypress 13 oder neuer und läuft nur in Chromium Browsern wie Chrome und Edge.

Der Nutzen ist schnell erklärt. Ein Test ist im CI rot, lokal aber grün. Früher hieß das: Branch auschecken, Daten nachbauen, hoffen. Mit Test Replay schaust du dir den roten Lauf direkt an und siehst, was die Anwendung in genau diesem Moment angezeigt hat.

Bei uns läuft Cypress mit Cypress Cloud täglich in Production, Test Replay ist dabei unser erster Blick auf jeden roten Run. Roland Golla ist offizieller Cypress Ambassador und arbeitet seit über 20 Jahren an Testing und Refactoring. Automatisiert testen wir bei NCA seit 2013. Wir wissen also, wie sich ein flackernder CI Job anfühlt und wie man ihn ruhig auseinandernimmt.

Im Cypress Workshop mit Roland üben wir die Triage mit Test Replay an echten Fehlern. Für ganze Teams gibt es die Cypress Remote Schulung. Wie ein KI Agent Replay Links selbst abholt, zeigt Cypress Cloud MCP für KI Agenten. In der Pipeline gehört Cypress zu unseren Quality Gates für KI Code, eingebettet in eine CI CD Pipeline mit Docker und Staging. Den Rahmen für Agenten im Team setzen die NCA Agentic AI Coding Guardrails.

Test Replay ist kein Screen Recording. Cypress speichert, was im Browser passiert, und baut die Seite im Viewer wieder auf. Darum kannst du Elemente anklicken und inspizieren, als wäre der Test gerade erst gelaufen.

Laut Cypress Doku zeichnet Test Replay auf:

• alle Cypress Befehle des Tests
• Netzwerk Requests mit Request und Response
• Konsolen Logs und JavaScript Fehler
• DOM Änderungen, Element Rendering und CSS Styles
• SVG, Iframes, Shadow DOM und Canvas Elemente

Nicht aufgezeichnet werden unter anderem Video und Audio Elemente, Server Sent Events, WebSockets, localStorage, sessionStorage und Cookies. Auch der Netzwerk Traffic von cy.request() fehlt im Replay. Wenn dein Fehler an einem WebSocket hängt oder an einem Cookie, siehst du im Replay nur die Folgen, nicht die Ursache.

Gut zu wissen: Test Replay ersetzt Videos als Debug Werkzeug. Die Doku empfiehlt sogar, die Video Aufnahme abzuschalten, wenn Test Replay aktiv ist. Das spart Zeit im CI Lauf.

Ein roter Run ist erst mal nur ein Signal. Die Frage ist: Liegt der Fehler in der Anwendung, im Test oder in der Umgebung? Triage heißt, diese Frage schnell und ohne Raten zu beantworten.

Der größte Zeitfresser war früher das lokale Nachstellen. Andere Daten, anderer Browser, andere Timings. Oft war der Fehler lokal einfach weg. Test Replay dreht das um. Du gehst nicht zum Fehler, der Fehler kommt zu dir.

Du öffnest Test Replay in Cypress Cloud an zwei Stellen: in der Run Übersicht per Hover über dem Test oder im Test Detail über jedem einzelnen Versuch im Fehlerbereich. Danach folgst du einem festen Ablauf. Die Tabelle zeigt, wie wir ihn strukturieren.

Nicht jeder will dafür in die Weboberfläche. Cypress bietet mit der Cypress Cloud CLI einen Weg ins Terminal. Das Paket heißt @cypress/cloud, der Befehl cy-cloud. Lokal meldest du dich per OAuth an, im CI über einen Personal Access Token.

Mit der Test ID bekommst du zuerst eine Zusammenfassung des Replays. Danach holst du dir gezielt die Befehle rund um den Fehler, dazu Netzwerk und Konsole.

Drei Optionen, die sich für die Triage lohnen:

• --aroundFailure 5 liefert die fünf Befehle vor dem Fehler plus den fehlgeschlagenen Befehl.
• --failedOnly zeigt nur fehlgeschlagene Befehle.
• --attempt wählt einen bestimmten Versuch, ohne Angabe ist es der letzte.

Das ist auch für KI Agenten interessant. Ein Agent liest Text besser als einen Viewer. Die Timeline als Text ist ein guter Kontext für die Fehleranalyse.

Mit Cypress Cloud MCP fragt ein KI Agent deine Runs direkt ab. Das Tool cypress_get_failed_tests liefert pro fehlgeschlagenem Versuch Testname, Spec, Fehlermeldung, Stack Trace und den Test Replay Link. Der Agent muss also nicht raten, wo er suchen soll.

So sieht ein Ablauf aus, der in der Praxis trägt:

• Der Agent holt die fehlgeschlagenen Tests zum Branch oder zur Run URL.
• Er liest Fehler und Stack Trace und gleicht sie mit dem lokalen Code ab.
• Er legt einen Vorschlag vor und hängt den Replay Link als Beleg an.
• Ein Mensch öffnet das Replay, prüft die Diagnose und gibt den Fix frei.

Der letzte Punkt ist wichtig. Der Agent schlägt vor, der Mensch entscheidet. Testdateien bleiben geschützt, und der Fix läuft wieder durch alle Quality Gates. Ein Agent, der einen roten Test grün macht, indem er die Assertion löscht, hat das Problem nur versteckt. Wie du das verhinderst, zeigt die Seite Cypress mit KI Agenten. Mehr dazu auch in unserem Beitrag zu agentischen Akzeptanztests.

Mit aktivierten Test Retries läuft ein Test mehrmals. Test Replay zeichnet jeden Versuch auf, und du schaltest im Viewer zwischen den Versuchen um. Genau das macht Replay so stark bei Flaky Tests.

Ein Test scheitert im ersten Versuch und besteht im zweiten. Du legst beide Replays nebeneinander und suchst den Unterschied:

• Kam ein Request im ersten Versuch später an?
• War ein Element noch mitten in einer Animation?
• Fehlte ein Datensatz, den ein anderer Test erst angelegt hat?

Die Retries selbst stellst du in der Cypress Konfiguration ein. Ein typisches Setup: Retries im CI an, lokal aus.

Retries sind ein Werkzeug zur Erkennung, keine Lösung. Ein Test, der nur im zweiten Versuch grün wird, hat ein Problem. Das Replay zeigt dir, welches.

Cypress Cloud ist ein US Anbieter. Test Replay lädt DOM, Netzwerk Daten und Konsolen Logs deiner Testläufe dort hoch. Das muss man klar sagen, gerade wenn Datenschutz im Team ein Thema ist.

Was Cypress laut Doku selbst tut:

• Sensible Werte in Netzwerk Requests und Responses werden vor dem Upload geschwärzt.
• Werte in Passwort und Zahlungsfeldern werden vor dem Upload durch Sternchen ersetzt.
• Test Replay lässt sich in den Projekteinstellungen abschalten, Canvas Aufzeichnung separat.

Ein Punkt aus der Doku verdient Aufmerksamkeit: Replays inklusive der Testdaten sind für alle sichtbar, die Zugriff auf das Projekt haben. Rechte im Projekt sind also auch Rechte auf die Daten.

Unsere Regel ist einfach: In Testumgebungen gibt es keine echten Personendaten. Wir arbeiten mit erzeugten Fake Daten, wie im Beitrag zu Faker Testdaten für lokale Entwicklung beschrieben. Wie du sie in Cypress per Fixtures und Seeding einspielst, erklärt die Seite zu Testdaten in Cypress. Dann zeichnet Test Replay nur auf, was ohnehin niemandem gehört. Wer gar keine Daten in die Cloud geben darf, betreibt Cypress ohne Cloud und verzichtet dafür auf Test Replay.

• Cypress 13 oder neuer und ein Projekt, das Runs an Cypress Cloud meldet.
• Chromium Browser im Testlauf: Chrome, Edge oder Electron. Firefox und WebKit werden nicht aufgezeichnet.
• Ein aktueller Browser zum Anschauen, Safari erst ab Version 16.4.

Zur Verfügbarkeit schreibt Cypress in der Doku: Test Replay steht in allen Cypress Cloud Plänen ohne Aufpreis zur Verfügung, mit Nutzungsgrenzen. Konkrete Grenzwerte nennt die Seite nicht. Replays lassen sich nur abrufen, solange der Run im Data Retention Zeitraum deiner Organisation liegt.

Und die fachlichen Grenzen: Test Replay zeigt, was im Browser passiert ist. Was im Backend schiefging, siehst du nur indirekt über Statuscodes und Responses. Für den Blick dahinter braucht es weiter Logs und Monitoring, bei uns sind das Sentry und Grafana.

Ein Werkzeug allein macht noch keine gute Triage. Wir helfen Teams, aus Test Replay eine Routine zu machen. Wer schaut wann auf rote Runs? Wo landet der Replay Link? Wann wird ein Test als flaky markiert und wann sofort repariert?

Gute Tests entstehen vor dem ersten roten Run. Mit Example Mapping klären wir Regeln und Beispiele mit dem Fachbereich. Daraus wird eine lebende Spezifikation, die Mensch und Agent gleich lesen. Wie Teams KI Agenten dabei sauber führen, beschreiben wir in Code Qualität mit KI Agenten.

Wenn Agenten Tests schreiben, gilt bei uns: Der Agent schreibt, ein Mensch reviewt und gibt frei. Die Regeln dafür stehen in einer AGENTS.md mit klaren Coding Regeln. Für Teams, die das gemeinsam aufbauen wollen, gibt es unser Vibe Coding Consulting und die KI Weiterbildung für Entwicklerteams.

Passend dazu im NCA Cypress Glossar: Cypress Parallelisierung für schnellere CI Läufe und Cypress UI Coverage für die Lücken, die kein roter Run zeigt.

Die wichtigsten Fragen zu Aufzeichnung, Triage, KI Agenten und Datenschutz bei Test Replay.