<aside> 💻

트러블 슈팅

• 전체 트러블 슈팅 </aside>

전체 트러블 슈팅

1. Jest 설정 초기 에러

Error: Jest encountered an unexpected token

• 원인: Jest가 ES Module과 TypeScript를 처리하지 못함
• 해결:

// jest.config.cjs
module.exports = {
  preset: "ts-jest",
  testEnvironment: "jest-environment-jsdom",
  transform: {
    "^.+\\\\.(ts|tsx)$": "ts-jest"
  }
};

2. Module Resolution 에러

Cannot find module '@/components/...' or its corresponding type declarations

• 원인: Jest가 TypeScript 경로 별칭(@/)을 인식하지 못함
• 해결: moduleNameMapper 설정 추가

moduleNameMapper: {
  "^@/(.*)$": "<rootDir>/src/$1"
}

3. TextEncoder 에러

ReferenceError: TextEncoder is not defined

• 원인: jsdom 환경에서 TextEncoder/TextDecoder가 정의되지 않음
• 해결: global object에 추가

import { TextEncoder, TextDecoder } from 'util';
global.TextEncoder = TextEncoder;
global.TextDecoder = TextDecoder;

4. Testing Library 타입 에러

Property 'toBeInTheDocument' does not exist on type 'Matchers<any>'

• 원인: jest-dom 타입이 올바르게 설정되지 않음