Wie man in Cypress Videos bei lokalen Runs erzeugt

Cypress ist ein beliebtes E2E-Testing-Framework, das nicht nur Screenshots, sondern auch Videos von Testdurchläufen aufnehmen kann. Gerade für die lokale Entwicklung und das Debugging sind diese Videoaufzeichnungen extrem hilfreich, um Fehlerquellen schnell zu identifizieren und zu dokumentieren.

Warum Videos bei lokalen Cypress-Runs aufnehmen?

• Effizientes Debugging: Videos zeigen exakt, was im Browser während des Tests passiert ist.
• Dokumentation: Nachvollziehbare Testdurchläufe für Teams und Code Reviews.
• Fehleranalyse: Schnelleres Erkennen von Flaky Tests oder UI-Problemen.

So aktivierst du Videos bei lokalen Cypress-Runs:

1. Videoaufnahme in der Cypress-Konfiguration aktivieren

Cypress nimmt standardmäßig keine Videos auf. Um Videos bei lokalen Runs zu erzeugen, musst du die Option video auf true setzen. Das geht entweder in der Konfigurationsdatei oder direkt per CLI-Befehl.

a) In der Konfigurationsdatei (cypress.config.js oder .ts):

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  video: true,
})

Oder für TypeScript:

import { defineConfig } from 'cypress'

export default defineConfig({
  video: true,
})

b) Direkt im Run-Command:

npx cypress run --config video=true

2. Cypress-Run ausführen

Führe deine Tests mit folgendem Befehl aus, um die Videoaufnahme zu starten:

npx cypress run --config video=true

Hinweis: Die Videoaufnahme funktioniert nur mit dem Befehl cypress run, nicht mit cypress open (dem interaktiven Modus)

3. Speicherort der Videos

Die aufgenommenen Videos werden standardmäßig im Ordner cypress/videos abgelegt. Du kannst diesen Pfad in der Konfiguration über die Option videosFolder anpassen

Weitere Video-Einstellungen

• Video-Kompression: Um die Dateigröße zu reduzieren, kannst du die Kompression aktivieren:

videoCompression: true, // oder eine Zahl für den CRF-Wert, z.B. 32

• Nur Videos bei Fehlern speichern: Mit Node-Events kannst du Videos nach erfolgreichen Runs automatisch löschen, um Speicherplatz zu sparen

Wichtige Hinweise

Feature	Unterstützt bei lokalen Runs?	Bemerkung
Videoaufnahme	Ja (nur mit cypress run)	Nicht mit cypress open
Unterstützte Browser	Chromium-basiert (Chrome, Electron, Edge)	Kein Support für Firefox
Speicherort	Standard: cypress/videos	Anpassbar über videosFolder
Kompression	Optional	Standard: keine Kompression

Fazit

Mit der Option video: true in der Konfiguration oder direkt im Run-Command kannst du in Cypress ganz einfach Videos deiner lokalen Testdurchläufe erzeugen. Diese Funktion ist ein mächtiges Werkzeug für die Entwicklung und Qualitätssicherung moderner Webanwendungen.

Du willst deine Cypress-Tests aufs nächste Level bringen?

Wir helfen Teams dabei, automatisiertes Testing nicht nur effizient, sondern auch nachhaltig zu integrieren – inklusive smarter Video-Dokumentation, optimierter Debugging-Prozesse und maßgeschneiderter CI-Setups.

👉 Lass uns sprechen – wir automatisieren deine Tests mit System!
Jetzt unverbindlich beraten lassen