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 }
  }
};

결정 가이드: 어떤 환경?

트랜스포머 치트시트

커버리지 임계값: 어떤 숫자?

• 핵심 경로 / 라이브러리: lines 90%+, branches 85%+.
• 기능 팀: lines 80%, branches 70%.
• 빠르게 바뀌는 UI: lines 60-70%; 비즈니스 로직은 더 높게, 레이아웃은 더 낮게.
• 프로토타입: 임계값을 완전히 끄세요; 커버리지를 게이트가 아니라 숫자로 추적하세요.

흔한 실수

• 순수 Node 코드에 jsdom 사용. 테스트가 느려지고 얻는 게 없습니다, node로 전환하세요.
• ESM 패키지용 transformIgnorePatterns 누락. 최신 패키지는 ESM 전용으로 배포됩니다; Jest에 이를 변환하라고 알려야 합니다.
• mapper 없이 이미지/CSS 목. 테스트에서 .png를 import하면 목 모듈 없이는 Jest가 넘어집니다.
• clearMocks를 false로 설정. 목이 테스트 간에 새고 실패가 비결정적이 됩니다. 기본으로 켜세요.