Cypress-Tests zu langsam? So beschleunigen Sie Cypress
Zuletzt aktualisiert
Wenn Ihre Cypress-Tests langsam laufen, können Sie Cypress meist beschleunigen, indem Sie sich programmatisch anmelden, feste Wartezeiten entfernen, eine gebaute App testen und Specs auf parallele Jobs verteilen. Dieser Leitfaden beschreibt jede dieser Maßnahmen und zeigt parallele Cypress-Tests in GitHub Actions, mit und ohne Cypress Cloud. Er ist Teil des Leitfadens zu langsamen E2E-Tests.
Warum Cypress langsam ist
Cypress führt pro Prozess jeweils eine Spec-Datei in einem einzelnen Browser aus, und eine Spec-Datei lädt die App für jeden Test neu. Zwei Faktoren verstärken sich dabei: ein langer Login oder Setup in beforeEach und feste cy.wait(ms)-Aufrufe. Bevor Sie etwas ändern, ermitteln Sie die langsamsten Specs. Die Cypress-Zusammenfassung gibt die Dauer jeder Spec aus; sortieren Sie danach.
Maßnahme 1: ohne UI anmelden
Verwenden Sie cy.session, um sich pro Spec-Lauf einmal anzumelden und Cookies und Storage danach wiederherzustellen, und cy.request für den Login-Aufruf selbst, statt Daten in ein Formular einzugeben:
Cypress.Commands.add("login", (email: string, password: string) => {
cy.session([email], () => {
cy.request("POST", "/api/login", { email, password });
});
});
Erstellen Sie Testdaten auf die gleiche Weise: cy.request an einen API-Endpunkt oder cy.task zum Befüllen der Datenbank, statt sich durch Formulare zu klicken.
Maßnahme 2: feste Wartezeiten entfernen
cy.wait(5000) kostet jedes Mal 5 Sekunden. Cypress wiederholt Assertions automatisch, prüfen Sie daher das Ergebnis. Wenn Sie auf einen Netzwerkaufruf warten müssen, versehen Sie ihn mit cy.intercept einem Alias und warten Sie auf diesen Alias:
cy.intercept("GET", "/api/orders*").as("orders");
cy.visit("/orders");
cy.wait("@orders");
cy.get("[data-cy=order-row]").should("have.length.at.least", 1);
Stubben Sie langsame Drittanbieter-Aufrufe (Karten, Analytics, Payment-Sandbox) mit cy.intercept, damit die Tests nicht von ihnen abhängen.
Maßnahme 3: gegen einen Production-Build testen
Ein Dev-Server kompiliert bei Bedarf, daher ist der erste Aufruf jeder Route langsam. Bauen Sie in der CI einmal, servieren Sie den Build und führen Sie Cypress dagegen aus. Mit der offiziellen Action übernehmen die Schritte build und start dies für Sie:
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
wait-on: "http://localhost:3000"
Maßnahme 4: große Specs aufteilen und das Richtige testen
Lange Specs mit 40 Tests lassen sich schlecht parallelisieren. Halten Sie Specs fokussiert und verlagern Sie Logikprüfungen in Unit- oder Komponententests. Das Cypress-Component-Testing führt Komponenten ohne vollständiges Laden der App aus und ist für UI-Zustände deutlich schneller. Siehe Unit-Tests vs. E2E-Tests.
Parallele Cypress-Tests in GitHub Actions
Option A: Cypress Cloud
Cypress Cloud verteilt Specs anhand historischer Laufzeiten auf mehrere Maschinen. Sie benötigen einen Record-Key und dieselbe Build-ID auf jeder Maschine; die offizielle Action übernimmt das:
jobs:
cypress:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
containers: [1, 2, 3, 4]
steps:
- uses: actions/checkout@v4
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
record: true
parallel: true
group: e2e
env:
CYPRESS_RECORD_KEY: ${{ secrets.CYPRESS_RECORD_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Cypress Cloud ist ein kostenpflichtiger Dienst mit einem kostenlosen Tarif; die aktuellen Limits finden Sie auf der eigenen Preisseite.
Option B: Specs selbst aufteilen, ohne Cloud
Das Open-Source-Plugin cypress-split verteilt Spec-Dateien über eine Matrix mithilfe von Umgebungsvariablen. Konfigurieren Sie es in cypress.config.ts und übergeben Sie dann Job-Index und Gesamtzahl:
strategy:
fail-fast: false
matrix:
index: [0, 1, 2, 3]
steps:
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
env:
SPLIT: 4
SPLIT_INDEX: ${{ matrix.index }}
Die genaue Einrichtung für Ihre Cypress-Version entnehmen Sie der README des Plugins. Eine Aufteilung nach Dateianzahl ist nicht zeitlich ausbalanciert, legen Sie daher die langsamsten Specs in getrennte Dateien. Der Leitfaden zum Test-Sharding erklärt das Balancieren, und der Planer schätzt Shard-Anzahl und Kosten.
Korrekt installieren und cachen
Cachen Sie den npm-Cache und das Cypress-Binary (~/.cache/Cypress). Die offizielle Action übernimmt beides für Sie. Verwenden Sie npm ci, nicht npm install. Wenn Ihr Job das Cypress-Binary bei jedem Lauf herunterlädt, zeigt das Log es an; beheben Sie dies zuerst.
Mehr CPU nutzen
Cypress startet einen Browser und Ihre App auf derselben Maschine. Ein Runner mit 2 vCPUs kann dabei zum Engpass werden und Timeouts verursachen, die wie instabile Tests aussehen. Vergleichen Sie mehr Kerne mit schnelleren GitHub Actions Runnern. compiler.dev war über 18 gemessene Stacks im Median 1.5× schneller (15 schneller, 2 gleich, 1 langsamer) als der 2-Kern-Runner von GitHub, und der Vergleichsmodus misst Ihre eigenen Jobs. Verwandt: Playwright-Tests langsam, instabile E2E-Tests und der Hub zu langsamer CI.
FAQ
Wie beschleunige ich Cypress?
Melden Sie sich mit cy.session und cy.request an, entfernen Sie feste Wartezeiten, testen Sie einen Production-Build und führen Sie Specs parallel über mehrere Jobs aus.
Kann ich parallele Cypress-Tests ohne Cypress Cloud ausführen?
Ja. Verteilen Sie Spec-Dateien mit einem Plugin wie cypress-split über eine Matrix oder schreiben Sie ein eigenes Skript, das Spec-Dateien einem Job-Index zuordnet. Die automatische zeitbasierte Ausbalancierung entfällt dann.
Warum laufen meine Cypress-Tests in der CI langsamer?
CI-Runner sind kleiner und starten kalt. Prüfen Sie die CPU-Auslastung, den Download des Binarys und ob Sie gegen einen Dev-Server testen.
Ist Cypress langsamer als Playwright?
Das hängt von der Suite ab. Beide sind bei guter Einrichtung schnell; vergleichen Sie anhand Ihrer eigenen Tests und lesen Sie Playwright-Tests langsam für die entsprechenden Maßnahmen.
Verwandt
- Docker-Build in der CI langsam? Ursache finden und behebenDocker-Build in CI zu langsam? Build-Kontext, .dockerignore, Layer-Reihenfolge, Cache-Misses und BuildKit prüfen und zuerst das größte Problem beheben.
- Instabile E2E-Tests: Ursachen und dauerhafte LösungenInstabile E2E-Tests beheben: falsche Wartezeiten, Testisolierung und gemeinsamer Datenbankstatus. Retries und Quarantäne nutzen, ohne Fehler zu verstecken.
- Jest langsam? Jest-Tests beschleunigen: Worker und --shardJest-Tests zu langsam? Beschleunigen Sie sie mit schnellerer TypeScript-Transformation, passender Worker-Anzahl und --shard in CI. Mit Konfiguration.
- Playwright-Tests langsam in CI? Mit Workern beschleunigenPlaywright-Tests in CI langsam? Beschleunigen mit mehr Workern, wiederverwendetem storageState, gecachten Browsern und --shard. Auch Python.