Vitest Helper

Vitest Helper는 Vitest를 활용한 테스트 코드 작성 역량을 팀 내에 정착시키기 위한 헬퍼 및 가이드 컬렉션입니다.
테스트 코드를 작업의 마무리 단계가 아닌, 개발 프로세스의 필수 요소로 만드는 것을 목표로 합니다.

목적

• •테스트 코드 작성의 진입 장벽 감소
• •일관된 테스트 작성 패턴 제공
• •기능 완료 시 테스트 코드 작성을 통한 안정성 확보
• •리팩토링 및 기능 확장 시 회귀 버그 방지

대상

• •Vitest를 사용하는 프론트엔드 / 백엔드 프로젝트
• •테스트 코드 작성 기준이 필요한 팀 또는 개인
• •테스트 문화 정착을 목표로 하는 개발 환경

핵심 원칙

• •모든 신규 기능은 테스트 코드 작성 후 완료로 간주
• •테스트는 구현이 아닌 행동(Behavior) 을 검증
• •테스트는 읽기 쉽고 의도가 명확해야 함
• •테스트가 어려운 코드는 구조 개선의 신호로 인식

제공 기능

1. 테스트 작성 가이드

• •Given / When / Then 패턴 기반 예제
• •명확한 테스트 네이밍 규칙
• •Unit / Integration 테스트 기준 정의

2. Vitest Helper Utilities

• •공통 Mock / Spy 헬퍼 제공
• •반복되는 테스트 설정 추상화
• •비동기 테스트 유틸 함수 제공

3. 테스트 품질 기준

• •정상 / 예외 케이스 테스트 기준
• •핵심 비즈니스 로직 커버리지 가이드
• •Definition of Done 기반 체크리스트

예제

더 자세한 예제는 references/ 디렉토리를 참고하세요:

• •component-test.md - 기본 컴포넌트 테스트
• •hook-test.md - 커스텀 훅 테스트
• •util-test.md - 유틸리티 테스트