Zum Inhalt springen

Jest langsam? Jest-Tests beschleunigen: Worker und --shard

Zuletzt aktualisiert: · Erstmals veröffentlicht:

Wenn Jest langsam ist, liegt es meist an einer langsamen TypeScript-Transformation, zu vielen oder zu wenigen Workern, schweren Modul-Imports, die in jeder Testdatei wiederholt werden, und einem einzigen CI-Job, der alles ausführt. Dieser Leitfaden zeigt, wie Sie Jest-Tests beschleunigen, einschließlich der Beschleunigung von Jest-Tests mit TypeScript und wie das Jest-Test-Sharding mit --shard funktioniert. Er ist Teil des Clusters langsame E2E-Tests, der auch langsame Integrationstests behandelt.

Ursachen, warum Jest langsam ist

Beginnen Sie mit Messwerten.

npx jest --verbose                 # per-test time
npx jest --listTests | wc -l       # how many files
npx jest --logHeapUsage            # memory per test file
npx jest --detectOpenHandles       # why it will not exit

Jest gibt standardmäßig eine Warnung für einzelne Tests aus, die länger als fünf Sekunden dauern. Achten Sie auf zwei Muster: wenige sehr langsame Dateien (diese beheben Sie gezielt) oder einen großen festen Aufwand pro Datei (Modulladen und Transformation), der jede Datei betrifft.

Zuerst die Transformation beheben

Typprüfende Transformationen sind bei TypeScript-Projekten die größte Ursache. ts-jest prüft standardmäßig jede Datei auf Typen. Entweder schalten Sie das ab und prüfen die Typen einmal mit tsc --noEmit in einem separaten Job, oder Sie wechseln zu einem reinen Transpile-Transformer wie @swc/jest:

// jest.config.js
module.exports = {
  transform: {
    "^.+\\.(t|j)sx?$": ["@swc/jest"],
  },
};

Mit ts-jest setzen Sie isolatedModules: true (oder diagnostics: false), um die Typprüfung pro Datei zu überspringen. Behalten Sie die Typprüfung in der CI als eigenen parallelen Job bei, dann bleibt die Korrektheit unverändert.

Worker bewusst festlegen

Jest führt Testdateien in parallelen Worker-Prozessen aus. Standardmäßig nutzt es die Anzahl der Kerne minus eins. Auf einem CI-Runner mit 2 vCPUs ist das ein Worker, die Suite läuft also faktisch seriell. Legen Sie den Wert explizit fest:

npx jest --maxWorkers=100%     # all cores, good on a CI runner dedicated to tests
npx jest --maxWorkers=50%      # leaves room for a dev machine
npx jest --runInBand           # one process; can be faster for tiny suites

Bei sehr kleinen Suites vermeidet --runInBand den Start der Worker. Bei großen Suites liegt die richtige Anzahl nahe an der Kernzahl. Auch der Speicher spielt eine Rolle: Werden Worker beendet, reduzieren Sie die Anzahl oder erhöhen den RAM des Runners.

Aufwand pro Datei senken

  • Barrel-Dateien: Der Import der index.ts eines Pakets kann Hunderte Module laden. Importieren Sie in Tests direkt aus der konkreten Datei.
  • Aufwendiges Setup: Verlagern Sie teures Setup nach globalSetup (läuft einmal), statt nach setupFilesAfterEnv (läuft vor jeder Testdatei).
  • Testumgebung: jsdom ist langsamer zu erstellen als node. Verwenden Sie @jest-environment node für Tests, die nicht auf das DOM zugreifen.
  • Cache: Der Transformations-Cache von Jest ist standardmäßig aktiv. Cachen Sie in der CI das cacheDirectory (npx jest --showConfig | grep cacheDirectory) mit actions/cache, abhängig von Lockfile und Konfiguration. Siehe Caching in GitHub Actions.
  • Nur geänderte Dateien: --onlyChanged oder --changedSince=origin/main führt nur Tests aus, die zu den Änderungen gehören. Gut für PR-Checks; auf main sollten Sie weiterhin einen vollständigen Lauf behalten.

Jest-Test-Sharding

Jest bietet seit Version 28 integriertes Sharding. --shard=index/count führt einen Abschnitt der Testdateien aus:

npx jest --shard=1/4
npx jest --shard=2/4

In GitHub Actions führen Sie pro Matrix-Job einen Abschnitt aus:

jobs:
  jest:
    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 jest --ci --maxWorkers=100% --shard=${{ matrix.shard }}/4

Das Sharding erfolgt nach Testdatei, nicht nach Laufzeit. Ein Shard kann daher langsamer sein, wenn er die großen Dateien erhält. Bei ungleichmäßigen Shards teilen Sie große Dateien auf oder verwenden einen laufzeitbasierten Splitter. Die Coverage muss zusammengeführt werden; der Leitfaden zum Test-Sharding zeigt, wie das geht, und der Planer schätzt die Anzahl der Shards.

Langsame Integrationstests in Jest

Wenn Tests auf eine Datenbank zugreifen, sollten sie günstig sein. Legen Sie das Schema einmal in globalSetup an, geben Sie jedem Worker eine eigene Datenbank (JEST_WORKER_ID ist in jedem Worker gesetzt) und kapseln Sie jeden Test in eine Transaktion, die zurückgerollt wird. Vermeiden Sie sleep; verwenden Sie jest.useFakeTimers() für zeitabhängige Logik.

Wenn Jest selbst der Engpass ist

Manche Teams wechseln zu Vitest für einen schnelleren Start; was dort zu prüfen ist, steht unter Vitest langsam, da Vitest eigene langsame Pfade hat. Eine Migration ist ein Projekt und kein Schalter, beheben Sie daher zuerst Transformation und Worker.

Der CI mehr CPU geben

Testsuiten mit vielen Dateien skalieren mit der Anzahl der Kerne. Wenn die Worker durch einen 2-vCPU-Runner begrenzt sind, vergleichen Sie die Optionen unter schnellere GitHub Actions Runner. compiler.dev war im Median 1.5× schneller über 18 gemessene Stacks (15 schneller, 2 gleich, 1 langsamer) als der 2-Core-Runner von GitHub, und der Vergleichsmodus misst Ihre eigenen Jobs. Das größere Bild finden Sie im Hub zu langsamer CI.

FAQ

Wie beschleunige ich Jest-Tests?

Wechseln Sie zu einer reinen Transpile-Transformation, setzen Sie --maxWorkers passend für Ihre Maschine, reduzieren Sie die Imports pro Datei, cachen Sie das Jest-Cache-Verzeichnis in der CI und verteilen Sie die Tests mit --shard auf mehrere Jobs.

Wie beschleunige ich Jest-Tests mit TypeScript?

Verwenden Sie @swc/jest oder ts-jest mit isolatedModules und führen Sie tsc --noEmit als separaten parallelen Job aus.

Unterstützt Jest Test-Sharding?

Ja, ab Jest 28: jest --shard=1/3. Die Aufteilung erfolgt nach Datei, daher kann die Verteilung ungleichmäßig sein.

Warum ist Jest in der CI langsamer als lokal?

Weniger Kerne (also weniger Worker), ein leerer Transformations-Cache und oft eine typprüfende Transformation. Beheben Sie diese Punkte nacheinander.

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

Kostenlos testen