jest

Jest 유닛 테스트 컨벤션

순수 함수(utils, helpers, lib, adapters)에 대한 유닛 테스트 작성 규칙. 컴포넌트/훅 테스트는 assayer 에이전트가 담당한다.

적용 대상

• utils/, helpers/, lib/, adapters/ 내 순수 함수
• 날짜 계산, 가격 계산, 포맷팅, 상태 변환, 데이터 매핑 등

---

파일 위치

{파일경로}/__tests__/{파일명}.test.ts

예시:

• utils/period.ts → utils/__tests__/period.test.ts
• adapters/mapOrderToVm.ts → adapters/__tests__/mapOrderToVm.test.ts

---

테스트 구조 (필수 준수)

import { 함수명 } from '../파일명';

describe('함수명', () => {
  // 날짜/시간 의존 함수는 필수
  beforeAll(() => {
    jest.useFakeTimers().setSystemTime(new Date('2025-01-15T00:00:00.000Z'));
  });

  afterAll(() => {
    jest.useRealTimers();
  });

  describe('정상 케이스', () => {
    it('일반적인 입력에 대해 올바른 결과 반환', () => {
      expect(함수(입력)).toEqual(기대값);
    });
  });

  describe('경계값', () => {
    it('최소값 처리', () => {});
    it('최대값 처리', () => {});
    it('빈 값 처리', () => {});
  });

  describe('에러 케이스', () => {
    it('잘못된 입력 시 에러/기본값 반환', () => {});
  });
});

---

테스트 케이스 도출 (필수)

카테고리	설명	예시
정상 케이스	일반적인 유효 입력	getPeriod('last14Days')
경계값	0, 빈 배열, null, undefined	formatPrice(0)
에러 케이스	잘못된 타입, 범위 초과	getPeriod('invalid')
정책 케이스	비즈니스 규칙 반영	last14Days는 14일 전부터

---

날짜 함수 필수 케이스

describe('getPeriod', () => {
  beforeAll(() => {
    jest.useFakeTimers().setSystemTime(new Date('2025-01-15T00:00:00.000Z'));
  });

  afterAll(() => {
    jest.useRealTimers();
  });

  it('last14Days - 오늘 기준 14일 전부터 오늘까지', () => {
    expect(getPeriod('last14Days')).toEqual(['2025-01-01', '2025-01-15']);
  });

  it('thisMonth - 해당 월 1일부터 말일까지', () => {
    expect(getPeriod('thisMonth')).toEqual(['2025-01-01', '2025-01-31']);
  });

  it('lastMonth - 이전 월 1일부터 말일까지', () => {
    expect(getPeriod('lastMonth')).toEqual(['2024-12-01', '2024-12-31']);
  });

  it('잘못된 옵션 입력 시 기본값 반환', () => {
    expect(getPeriod('invalid')).toEqual(['2025-01-01', '2025-01-15']);
  });
});