Next.js 테스팅
우선순위: P1 (높음)
구조
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # MSW 핸들러
구현 가이드라인
- 유닛 테스트: 속도를 위해 Vitest를, 컴포넌트 동작 테스트를 위해 **React Testing Library (RTL)**를 사용하세요. Arrange-Act-Assert (AAA) 패턴을 따르세요.
- E2E 테스트: 풀스택 App Router 검증을 위해 Playwright를 사용하세요. 사용자 흐름 (예: 로그인, 체크아웃)에 집중하세요.
- 네트워킹: **Mock Service Worker (MSW)**를 사용하여 모든 내부/외부 API 경계를 모킹하세요.
server 및 browser 핸들러가 올바르게 구성되었는지 확인하세요.
- RSC 테스트: **React Server Components (RSC)**를 일반 라이브러리와 동일한 패턴으로 테스트하세요 (SSR 호환 테스트). 복잡한 비동기 데이터 로딩 로직에는 E2E 테스트를 선호하세요.
- 상호작용: **
userEvent (비동기)**를 사용하여 사용자 동작을 시뮬레이션하세요: await user.click(button).
- 선택자: 접근성 테스트를 위해
getByRole / **findByRole**를 우선 사용하세요. **data-testid**는 대체 수단으로만 사용하세요.
- 환경: 컴포넌트 테스트를 위해 **
vitest.config.ts**에서 jsdom 또는 **happy-dom**을 설정하세요.
- 리포팅: 테스트가 CI 게이트를 위해 JSON 커버리지 보고서를 생성하도록 하세요. 핵심 라이브러리에 대해 80% 이상의 커버리지를 목표로 하세요.
안티패턴
- 테스트에서 실제 네트워크 사용 금지: 항상 MSW 핸들러 또는 모의 객체를 사용하세요.
- 구현 테스트 금지: 내부 메서드가 아닌 사용자 동작을 테스트하세요.
- 유닛 로직에 무거운 E2E 사용 금지: 격리된 로직 테스트에는 Vitest를 사용하세요.
- 전역 상태 누수 금지: 각 테스트 후 MSW 핸들러와 모의 객체를 초기화하세요.
참고자료