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.
Test Replay ist unser erster Blick auf jeden roten Run. Bei uns läuft Cypress mit Cypress Cloud täglich in Production, in GitHub Actions und GitLab CI. Wird ein Job rot, öffnen wir zuerst das Replay am fehlgeschlagenen Versuch und lesen DOM, Requests und Konsole, bevor jemand lokal etwas nachbaut. Erst danach entscheiden wir, ob App, Test oder Umgebung schuld ist. Roland Golla ist offizieller Cypress Ambassador und kennt die Werkzeuge von Cypress Cloud aus erster Hand.
Mit deinem Team machen wir aus Test Replay eine feste Routine für rote Runs. Wir üben die Triage an echten Fehlern im Cypress Workshop mit Roland Golla oder in der Cypress Remote Schulung für Teams. 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.
Ein Tag inhouse mit Roland Golla, offizieller Cypress Ambassador und seit über 20 Jahren in Testing und Refactoring zu Hause. Auf unserem YouTube Kanal zeigt er in über 70 Live Coding Tutorials, wie Cypress in echten Projekten läuft. Dazu kommt unser Open Source Plugin NCA TESTIFY: Basistests für jede Website, mit einer Zeile im CI/CD Setup. Im Workshop lernt euer Team Setup, stabile Selektoren, Custom Commands und Tests in der Pipeline.
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:
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. Hängt dein Fehler an einem WebSocket oder einem Cookie, siehst du im Replay nur die Folgen. Die Ursache musst du dann über Logs suchen.
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. Mit Test Replay entfällt dieser Schritt. Du siehst den Fehler genau so, wie er im CI aufgetreten ist.
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.
npm install --global @cypress/cloud
cy-cloud login
cy-cloud status
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.
cy-cloud replay info --testId <testId>
cy-cloud replay timeline --testId <testId> --commands --aroundFailure 5 --network --logs
Drei Optionen, die sich für die Triage lohnen:
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:
Welche Regeln für Agenten, Review und Freigabe bei uns gelten, steht auf der 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. Das hilft besonders bei Flaky Tests.
Ein Test scheitert im ersten Versuch und besteht im zweiten. Du legst beide Replays nebeneinander und suchst den Unterschied:
Wie du Retries in der Cypress Konfiguration einstellst, zeigt die Seite Flaky Tests in Cypress mit Beispielen für CI und lokale Läufe.
Ein Retry zeigt dir, dass ein Test wackelt. Wird ein Test nur im zweiten Versuch grün, hat er ein Problem, und das Replay zeigt dir, welches.
Test Replay lädt DOM, Netzwerk Daten und Konsolen Logs deiner Testläufe in Cypress Cloud hoch. Das muss man klar sagen, gerade wenn Datenschutz im Team ein Thema ist.
Was Cypress laut Doku selbst tut:
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.
Welche Daten in Testläufe gehören und warum wir dort nur Fake Daten nutzen, erklärt die Seite Testdaten in Cypress. Wer gar keine Daten in die Cloud geben darf, betreibt Cypress ohne Cloud und verzichtet dafür auf Test Replay.
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.
Test Replay allows you to interact with tests as they occurred in CI.
Cypress Cloud MCP verbindet KI Agenten direkt mit Testergebnissen, Flaky Tests und Test Replay. Setup für OpenCode und Claude Code, eingeordnet von NCA.
Mehr erfahren
Quality Gates für KI generierten Code: Linting, Tests, Review Agents und CI Pipelines setzen CLAUDE.md Regeln automatisch durch. Praxiswissen von NCA
Mehr erfahrenEin 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, die Regeln landen in einer AGENTS.md mit klaren Coding Regeln.
Aufbauen kannst du das mit unserer Vibe Coding Beratung und der 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.
Optimieren Sie Ihre Webseite mit Astro JS und nutzen Sie die Vorteile einer schnellen, sicheren und barrierefreien Webseite. Erfüllen Sie die gesetzlichen Anforderungen und verbessern Sie die Benutzererfahrung Ihrer Webseite. Mit Astro JS können Sie die Ladezeit reduzieren, die Sicherheit maximieren und die SEO-Optimierung verbessern. Kontaktieren Sie uns, um mehr zu erfahren und um Ihre Webseite auf ein neues Level zu heben.
Die wichtigsten Fragen zu Aufzeichnung, Triage, KI Agenten und Datenschutz bei Test Replay.
Test Replay ist eine Funktion von Cypress Cloud, die fehlgeschlagene Tests aus dem CI im Browser nachspielt. Du siehst DOM, Netzwerk Requests, Konsole und alle Cypress Befehle so, wie sie im Lauf passiert sind. Elemente lassen sich inspizieren wie im echten Browser. So findest du Ursachen, ohne den Fehler lokal nachzustellen.
Laut Cypress Doku brauchst du Cypress 13 oder neuer. Dazu muss dein Projekt Runs an Cypress Cloud melden, und die Tests müssen in einem Chromium Browser laufen, also Chrome, Edge oder Electron. Firefox und WebKit werden nicht aufgezeichnet. Zum Anschauen reicht ein aktueller Browser, Safari erst ab Version 16.4.
Ja. Laut Cypress Doku steht Test Replay in allen Cypress Cloud Plänen ohne Aufpreis zur Verfügung, allerdings mit Nutzungsgrenzen. Konkrete Grenzwerte nennt die Doku nicht. Prüf deshalb im eigenen Account, welche Grenzen gelten. Funktionen wie Flaky Test Management setzen dagegen laut Doku mindestens den Team Plan voraus.
Du liest zuerst Fehlermeldung und Stack Trace. Dann öffnest du das Replay am fehlgeschlagenen Versuch und springst zum Fehler. Von dort gehst du die Befehle zurück, prüfst Netzwerk und Konsole und ordnest ein: Bug in der App, Fehler im Test oder Problem der Umgebung. Der Replay Link kommt als Beleg ins Ticket.
Ja, über Cypress Cloud MCP. Das Tool cypress_get_failed_tests liefert pro Versuch Fehler, Stack Trace und den Test Replay Link. Die Cypress Cloud CLI gibt die Replay Timeline zusätzlich als Text aus. Der Agent macht daraus einen Vorschlag, den ein Mensch im Replay prüft und freigibt.
Laut Doku fehlen unter anderem Video und Audio Elemente, Server Sent Events, WebSockets, localStorage, sessionStorage und Cookies. Auch Netzwerk Traffic von cy.request() ist nicht im Replay. Hängt dein Fehler an einem dieser Punkte, siehst du im Replay nur die Folgen. Dann helfen zusätzliche Logs im Test oder in der Anwendung.
Für das Debugging ja. Cypress beschreibt Test Replay als Ersatz für das Debuggen per Video. Die Doku empfiehlt sogar, die Video Aufnahme abzuschalten, wenn Test Replay aktiv ist. Ein Video zeigt nur Pixel, ein Replay zeigt DOM, Requests und Konsole. Du kannst Elemente anklicken und inspizieren.
Mit aktivierten Retries zeichnet Test Replay jeden Versuch auf. Du vergleichst den roten mit dem grünen Versuch und suchst den Unterschied. Typische Funde sind ein langsamer Request, eine laufende Animation oder fehlende Testdaten. So wird aus einem vagen Gefühl von Flakiness eine konkrete Ursache, die du gezielt beheben kannst.
Mit Fake Daten in der Testumgebung ja, mit echten Personendaten wird es heikel, weil die Replay Daten in Cypress Cloud liegen. Cypress schwärzt laut Doku sensible Netzwerk Werte und ersetzt Passwort und Zahlungsfelder durch Sternchen. Das reicht als alleinige Absicherung nicht aus. Wer gar nichts hochladen darf, schaltet Test Replay ab.
Laut Cypress Doku sind Test Replays inklusive der Testdaten für alle sichtbar, die Zugriff auf das Projekt in Cypress Cloud haben. Rechte im Projekt sind also auch Rechte auf die aufgezeichneten Daten. Vergib Zugänge deshalb bewusst und prüf regelmäßig, wer noch Zugriff hat, etwa nach Teamwechseln oder dem Ende externer Zusammenarbeit.
Ja. In Cypress Cloud öffnest du die Projekteinstellungen und findest dort einen eigenen Bereich für Test Replay. Du kannst die Aufzeichnung komplett abschalten. Die Canvas Aufzeichnung lässt sich separat deaktivieren, weil sie laut Doku ressourcenintensiv sein kann. Ohne Test Replay bleiben Fehlermeldungen, Stack Traces und Screenshots als Grundlage.
Ja, über die Cypress Cloud CLI. Du installierst das Paket @cypress/cloud und meldest dich mit cy-cloud login an. Mit cy-cloud replay info bekommst du eine Zusammenfassung, mit cy-cloud replay timeline die Befehle, Netzwerk Events und Logs rund um den Fehler. Das ist praktisch für Skripte und für KI Agenten.
