Jest 設定ジェネレーター

出力例：React + TypeScript プロジェクト

module.exports = {
  preset: "ts-jest",
  testEnvironment: "jsdom",
  setupFilesAfterEach: ["<rootDir>/jest.setup.ts"],
  moduleNameMapper: {
    "\\.(css|less|scss|sass)$": "identity-obj-proxy",
    "\\.(jpg|jpeg|png|gif|svg)$": "<rootDir>/__mocks__/fileMock.js",
    "^@/(.*)$": "<rootDir>/src/$1"
  },
  testPathIgnorePatterns: ["/node_modules/", "/dist/", "/build/"],
  transform: {
    "^.+\\.tsx?$": ["ts-jest", { tsconfig: "tsconfig.test.json" }]
  },
  collectCoverageFrom: [
    "src/**/*.{ts,tsx}",
    "!src/**/*.d.ts",
    "!src/**/*.stories.*"
  ],
  coverageThreshold: {
    global: { branches: 80, functions: 80, lines: 85, statements: 85 }
  }
};

選び方ガイド：どの環境にすべきか？

トランスフォーマー早見表

カバレッジのしきい値：どの数値にすべきか？

• クリティカルパス／ライブラリ：行 90% 以上、分岐 85% 以上。
• 機能チーム：行 80%、分岐 70%。
• 頻繁に変わる UI：行 60〜70%。ビジネスロジックはより高く、レイアウトはより低く狙う。
• プロトタイプ：しきい値は完全に無効化し、カバレッジはゲートではなく数値として追跡する。

よくある間違い

• 純粋な Node コードに jsdom を使う。 テストが遅くなるだけで得るものはありません。node に切り替えましょう。
• ESM パッケージに transformIgnorePatterns を設定し忘れる。 最近のパッケージは ESM のみで配布されるため、Jest に変換するよう指示する必要があります。
• マッパーなしで画像や CSS をモックする。 テストで .png をインポートすると、モックモジュールがない Jest は動かなくなります。
• clearMocks を false にする。 モックがテスト間で漏れ、失敗が非決定的になります。デフォルトで有効にしましょう。