Zum Inhalt springen

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.

Lassen Sie diese Cypress-Tests auf compiler.dev laufen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen