コンテンツへスキップ

Jestが遅い? Jestテストを高速化する:ワーカーと--shard

最終更新 · 初回公開

Jest が遅い場合、よくある原因は、TypeScript の変換処理が遅いこと、ワーカー数が多すぎるか少なすぎること、テストファイルごとに重いモジュールを繰り返し読み込んでいること、そして 1 つの CI ジョブですべてを実行していることです。このガイドでは、TypeScript を使った場合の Jest テストの高速化方法と、--shard による Jest のテストシャーディングの仕組みを説明します。このガイドは 遅い E2E テスト のクラスターの一部であり、遅い統合テストについても扱います。

Jest が遅い理由を調べる

まずは数値を確認します。

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 はデフォルトで、5 秒を超える個々のテストに対して遅いテストの警告を表示します。次の 2 つのパターンに注目してください。少数の非常に遅いファイル(これは個別に修正します)、または各ファイルにかかる大きな固定コスト(モジュールの読み込みと変換)です。後者はすべてのファイルに影響します。

まず変換処理を修正する

TypeScript プロジェクトでは、型チェックを伴う変換処理が最大の原因になることが多いです。ts-jest はデフォルトでファイルごとに型チェックを行います。型チェックを無効にし、別ジョブで tsc --noEmit によって一度だけ型チェックを行うか、@swc/jest のようなトランスパイルのみのトランスフォーマーに切り替えてください。

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

ts-jest を使う場合は、isolatedModules: true(または diagnostics: false)を設定して、ファイルごとの型チェックを省略できます。型チェックは CI で独立した並列ジョブとして残しておけば、正しさは変わりません。

ワーカー数を意図的に設定する

Jest はテストファイルを並列のワーカープロセスで実行します。デフォルトではコア数から 1 を引いた数を使います。2 vCPU の CI ランナーでは 1 ワーカーになるため、実質的にはスイートが直列で実行されます。明示的に設定してください。

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

非常に小さなスイートでは、--runInBand を使うとワーカーの起動を避けられます。大きなスイートでは、適切な数はコア数に近い値になります。メモリも重要です。ワーカーが強制終了される場合は、ワーカー数を減らすか、ランナーの RAM を増やしてください。

ファイルごとのオーバーヘッドを減らす

  • バレルファイル: パッケージの index.ts をインポートすると、数百のモジュールが読み込まれることがあります。テストでは、具体的なファイルから直接インポートしてください。
  • 重いセットアップ: 負荷の高いセットアップは、テストファイルごとに実行される setupFilesAfterEnv ではなく、1 回だけ実行される globalSetup に移してください。
  • テスト環境: jsdom は node よりも作成に時間がかかります。DOM を使わないテストには @jest-environment node を使用してください。
  • キャッシュ: Jest の変換キャッシュはデフォルトで有効です。CI では、ロックファイルと設定をキーにして、cacheDirectory(npx jest --showConfig | grep cacheDirectory で確認できます)を actions/cache でキャッシュしてください。詳しくは GitHub Actions のキャッシュ を参照してください。
  • 変更されたファイルのみ: --onlyChanged または --changedSince=origin/main を使うと、変更に関連するテストだけを実行できます。PR のチェックに適しています。main では完全な実行を維持してください。

Jest のテストシャーディング

Jest はバージョン 28 以降、シャーディングを組み込みで備えています。--shard=index/count を使うと、テストファイルの一部だけを実行できます。

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

GitHub Actions では、マトリクスの各ジョブで 1 つのスライスを実行します。

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

シャーディングはテストの実行時間ではなくテストファイル単位で行われるため、大きなファイルが特定のシャードに集中すると、そのシャードだけが遅くなることがあります。シャードの負荷が偏る場合は、大きなファイルを分割するか、実行時間に基づいて分割するツールを使ってください。カバレッジは結合する必要があります。その方法は テストシャーディングのガイド を参照してください。シャード数の見積もりには プランナー を利用できます。

Jest 内の遅い統合テスト

テストでデータベースにアクセスする場合は、そのコストを抑えてください。globalSetup でスキーマを一度だけ作成し、各ワーカーに独自のデータベースを割り当て(JEST_WORKER_ID は各ワーカーで設定されます)、各テストをロールバックするトランザクションで囲みます。sleep は避け、時間に依存するロジックには jest.useFakeTimers() を使ってください。

Jest 自体がボトルネックになる場合

起動を速めるため Vitest に移行するチームもあります。Vitest には独自の遅くなる要因があるため、確認すべき点は Vitest が遅い を参照してください。移行はフラグを変えるだけでは済まないプロジェクトなので、まずは変換処理とワーカーを修正してください。

CI により多くの CPU を割り当てる

ファイル数の多いテストスイートは、コア数に応じてスケールします。ワーカー数が 2 vCPU のランナーに制限されている場合は、高速な GitHub Actions ランナー の選択肢を比較してください。compiler.dev は、測定した 18 のスタックで GitHub の 2 コアランナーより中央値で 1.5 倍高速でした(15 件は高速、2 件は同等、1 件は低速)。比較モードでは、お使いのジョブを直接計測できます。より広い全体像は 遅い CI のハブ にまとめています。

よくある質問

Jest のテストを高速化するにはどうすればよいですか?

トランスパイルのみの変換に切り替え、お使いのマシンに合わせて --maxWorkers を設定し、ファイルごとのインポートを減らし、CI で Jest のキャッシュディレクトリをキャッシュし、--shard で複数のジョブに分割してください。

TypeScript で Jest のテストを高速化するにはどうすればよいですか?

isolatedModules を指定して @swc/jest または ts-jest を使い、tsc --noEmit は独立した並列ジョブとして実行してください。

Jest はテストシャーディングに対応していますか?

はい、Jest 28 以降で対応しています。jest --shard=1/3 のように指定します。分割はファイル単位で行われるため、負荷が偏る場合があります。

なぜ CI の Jest はローカルより遅いのですか?

コア数が少ない(そのためワーカー数も少ない)こと、変換キャッシュが空であること、そして型チェックを伴う変換処理を使っていることが多いためです。それぞれ順番に修正してください。

この Jest テストを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す