Zum Inhalt springen

Playwright-Tests langsam in CI? Mit Workern beschleunigen

Zuletzt aktualisiert: · Erstmals veröffentlicht:

Wenn Ihre Playwright-Tests langsam sind, liegt der Fehler meist nicht an Playwright. Ursache sind eher zu niedrig gesetzte Worker, ein Login, der in jedem Test wiederholt wird, Browser, die bei jedem Lauf neu heruntergeladen werden, oder ein langer serieller Job. Dieser Leitfaden zeigt anhand echter Konfiguration, wie Sie Playwright-Tests beschleunigen, einschließlich Test-Sharding für Playwright und des Python-Pendants. Er gehört zum Leitfaden zu langsamen E2E-Tests.

Warum die Ausführung von Playwright-Tests langsam ist

Messen Sie zuerst. Führen Sie die Tests mit den Reportern list und json aus und sortieren Sie anschließend nach der Dauer:

npx playwright test --reporter=list,json

Teilen Sie die Laufzeit Ihres CI-Jobs in Installation, Browser-Installation, Serverstart und Testlauf auf. Macht der Testlauf weniger als die Hälfte der Gesamtzeit aus, beheben Sie zuerst das Setup, bevor Sie die Tests anfassen.

Dateien und Tests parallel ausführen

Playwright führt Testdateien standardmäßig parallel aus, Tests innerhalb einer Datei laufen dagegen nacheinander. Setzen Sie fullyParallel, damit jeder Test parallel läuft, und legen Sie die Worker in CI explizit fest:

// playwright.config.ts
import { defineConfig } from "@playwright/test";

export default defineConfig({
  fullyParallel: true,
  workers: process.env.CI ? 4 : undefined,
  retries: process.env.CI ? 1 : 0,
  use: { trace: "on-first-retry" },
  reporter: process.env.CI ? [["blob"], ["list"]] : "list",
});

Standardmäßig nutzt Playwright etwa die Hälfte der logischen CPU-Kerne. Auf einem Runner mit 2 vCPUs bedeutet das einen Worker, weshalb sich Playwright auf einem kleinen Runner träge anfühlt. Setzen Sie die Anzahl der Worker nicht weit über die Kernzahl: Browser sind ressourcenintensiv, und überlastete CPUs führen zu Timeouts, die wie Flakiness aussehen.

Einmal anmelden mit storageState

Die Anmeldung über die Oberfläche vor jedem Test ist die häufigste Zeitverschwendung. Melden Sie sich einmal in einem Setup-Projekt an und verwenden Sie den gespeicherten Zustand wieder:

projects: [
  { name: "setup", testMatch: /auth\.setup\.ts/ },
  {
    name: "chromium",
    use: { storageState: "playwright/.auth/user.json" },
    dependencies: ["setup"],
  },
],

Legen Sie Testdaten über Ihre API oder Datenbank an, statt sie über die Oberfläche einzugeben. Wenn Ihre Tests pro Worker eindeutige Benutzer brauchen, erstellen Sie diese in einer Fixture mit Worker-Scope.

Feste Wartezeiten vermeiden

Entfernen Sie page.waitForTimeout(). Verwenden Sie webbasierte Assertions, die automatisch warten, etwa await expect(page.getByRole("button", { name: "Save" })).toBeEnabled(). Warten Sie mit page.waitForResponse auf eine bestimmte Antwort, wenn die Oberfläche von einer Anfrage abhängt. Blockieren Sie mit page.route alles, was Sie nicht benötigen, etwa Analytics und Schriften, um die Ladezeit der Seite zu verkürzen.

Die Anwendung nur einmal starten

Nutzen Sie die Option webServer, damit Playwright die Anwendung einmal für den gesamten Lauf startet. Verwenden Sie in CI einen Produktions-Build statt eines Dev-Servers, der bei Bedarf kompiliert:

webServer: {
  command: "npm run start",
  url: "http://localhost:3000",
  reuseExistingServer: !process.env.CI,
},

Test-Sharding mit Playwright

Sharding verteilt die Suite auf mehrere Jobs. Playwright bietet das mit --shard=x/y direkt an. Verwenden Sie den Blob-Reporter, damit sich die Berichte anschließend zusammenführen lassen:

jobs:
  e2e:
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        shard: [1, 2, 3, 4]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: npm }
      - run: npm ci
      - run: npx playwright install --with-deps chromium
      - run: npx playwright test --shard=${{ matrix.shard }}/4
      - uses: actions/upload-artifact@v4
        if: ${{ !cancelled() }}
        with:
          name: blob-report-${{ matrix.shard }}
          path: blob-report
  merge:
    needs: e2e
    if: ${{ !cancelled() }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22, cache: npm }
      - run: npm ci
      - uses: actions/download-artifact@v4
        with: { path: all-blob-reports, pattern: blob-report-*, merge-multiple: true }
      - run: npx playwright merge-reports --reporter html ./all-blob-reports

Anzahl der Shards: Nutzen Sie den Planer für Test-Sharding, um Laufzeit und Kosten abzuschätzen, und lesen Sie den Leitfaden zum Sharding zur Lastverteilung. Mit fullyParallel: true verteilt Playwright auf Testebene, was gleichmäßigere Shards ergibt als eine Aufteilung auf Dateiebene.

Nur den benötigten Browser installieren

npx playwright install --with-deps chromium lädt einen Browser statt drei herunter. Die Playwright-Dokumentation weist darauf hin, dass das Zwischenspeichern von Browser-Downloads oft wenig bringt, weil das Wiederherstellen eines großen Caches etwa so lange dauert wie der Download. Messen Sie deshalb, bevor Sie einen Cache hinzufügen. Alternativ führen Sie die Tests im offiziellen Playwright-Container-Image aus, in dem Browser und Systemabhängigkeiten bereits vorhanden sind.

Playwright mit Python beschleunigen

Das Python-Paket verwendet pytest. Führen Sie die Tests mit pytest-xdist parallel aus und verwenden Sie eine Fixture mit Session-Scope, um den authentifizierten Zustand wiederzuverwenden:

pip install pytest-playwright pytest-xdist
pytest -n 4 --browser chromium

Jeder xdist-Worker ist ein eigener Prozess mit eigenem Browser, daher müssen die Daten pro Worker isoliert sein. Verteilen Sie Python-Tests mit den Ansätzen aus langsame pytest-Tests auf mehrere Jobs. Die Anmeldung wiederverwenden Sie, indem Sie context.storage_state(path="state.json") einmal speichern und storage_state an browser.new_context übergeben.

Den Browsern mehr CPU geben

Wenn Worker hinter zwei Kernen warten, ist die Hardware der nächste Hebel. Siehe schnellere GitHub Actions Runner. Wenn Sie compiler.dev ausprobieren, führt der Vergleichsmodus Ihre eigenen Jobs aus, was wichtig ist, denn Beschleunigungen bei Browser-Tests hängen von Ihrer Suite ab. Über 18 gemessene Stacks war der Median 1.5× schneller (15 schneller, 2 gleich, 1 langsamer) als der 2-Kern-Runner von GitHub.

In einem Monorepo bauen Sie die Anwendung einmal und teilen sie zwischen den Shards: Playwright in einem Monorepo beschleunigen. Instabile E2E-Tests erklärt, warum Wiederholungen und langsame Suiten zusammenhängen. Cypress-Tests langsam ist der Schwesterleitfaden, falls Sie beide Werkzeuge nutzen. Der Hub zu langsamer CI behandelt den Rest der Pipeline.

FAQ

Wie beschleunige ich Playwright-Tests?

Verwenden Sie fullyParallel, setzen Sie die Worker passend zu den Kernen, melden Sie sich einmal mit storageState an, entfernen Sie feste Wartezeiten, starten Sie die Anwendung einmal und verteilen Sie die Tests mit --shard auf mehrere Jobs.

Wie viele Worker sollte Playwright in CI verwenden?

Etwa einen pro Kern bei leichteren Anwendungen, weniger bei schweren. Messen Sie die Gesamtzeit und die Fehlerquote bei 1, 2 und 4 Workern.

Wie funktioniert Playwright-Sharding?

--shard=2/4 führt den zweiten von vier Abschnitten der Suite aus. Führen Sie jeden Abschnitt in einem eigenen Job aus und führen Sie die Blob-Berichte anschließend zusammen.

Warum sind meine Playwright-Tests in CI langsamer?

CI-Maschinen haben weniger Kerne, kalte Caches und einen frisch installierten Browser. Vergleichen Sie Worker-Anzahl und Setup-Zeit mit Ihrem lokalen Lauf.

Führen Sie diese Playwright-Tests auf compiler.dev aus Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen