메인 콘텐츠로 건너뛰기
Vitest로 작성된 테스트를 효과적으로 디버깅하는 방법을 다룹니다.

Vitest 디버깅 방법

Sonamu는 Vitest를 테스트 프레임워크로 사용합니다. 다양한 디버깅 방법을 제공합니다.

VSCode 디버거 사용

1. launch.json 설정

.vscode/launch.json:

2. 디버깅 실행

  1. 테스트 파일 열기
    • 디버깅하려는 .test.ts 파일 열기
  2. 브레이크포인트 설정
    • 줄 번호 왼쪽 클릭하여 빨간 점 표시
  3. 디버거 시작
    • F5 키 또는 “Run and Debug” 패널에서 “Debug Current Test File” 선택
  4. 디버깅
    • 브레이크포인트에서 멈추면 변수 검사
    • F10 (Step Over), F11 (Step Into) 등 사용

콘솔 로깅

console.log 사용

가장 간단한 디버깅 방법:

구조화된 로깅

특정 테스트만 실행

test.only

describe.only

CLI로 특정 테스트 실행

Watch 모드

자동 재실행

파일을 수정하면 관련 테스트가 자동으로 재실행됩니다.

Watch 모드 단축키

테스트 실행 중:
  • a: 모든 테스트 재실행
  • f: 실패한 테스트만 재실행
  • t: 특정 테스트 필터
  • q: 종료

UI 모드 (vitest —ui)

실행

브라우저에서 http://localhost:51204/__vitest__/ 열림 기능:
  • 테스트 계층 구조 시각화
  • 실패한 테스트 필터링
  • 개별 테스트 재실행
  • 코드 커버리지 확인
  • 콘솔 출력 확인

에러 디버깅

상세한 에러 메시지

try-catch로 에러 확인

비동기 코드 디버깅

async/await 확인

타임아웃 증가

모킹 디버깅

Mock 호출 확인

Mock 리셋 확인

데이터베이스 상태 확인

쿼리 로깅

테스트 후 데이터 확인

Coverage 디버깅

커버리지 확인

커버되지 않은 코드 찾기

Vitest 설정 디버깅

설정 확인

vitest.config.ts:

환경 변수 확인

병렬 실행 디버깅

격리 모드 비활성화

일부 테스트는 병렬 실행 시 문제가 발생할 수 있습니다:

순차 실행

스냅샷 디버깅

스냅샷 업데이트

스냅샷 확인

타입 체크 디버깅

타입 에러 확인

타입 테스트

테스트 격리 문제

beforeEach/afterEach 확인

메모리 누수 디버깅

메모리 사용량 확인

리소스 정리 확인

Best Practices

1. 작은 단위로 테스트

2. 의미 있는 테스트 이름

3. AAA 패턴 (Arrange-Act-Assert)

4. 실패 시 충분한 정보

관련 문서