스냅샷 테스트(snapshot testing)란 무엇인가요?

Question

Accepted Answer

**스냅샷 테스트(snapshot testing)**는 어떤 출력(흔히 UI 컴포넌트의 렌더링 출력이나 데이터 구조)의 "스냅샷"을 캡처하고 이후 실행을 그에 대해 비교합니다 — 출력이 변경되면 표시합니다. 의도하지 않은 변경을 감지하는 데 유용하지만, 이해해야 할 한계가 있습니다.

## 스냅샷 테스트의 동작 방식

```text
1. 첫 실행 → 테스트가 출력(예: 렌더링된 컴포넌트)을 스냅샷 파일로 기록
2. 이후 실행 → 현재 출력을 저장된 스냅샷과 비교:
   → 일치 → 통과; 다름 → 실패 (출력이 변경됨)
3. 변경이 의도적이면 → 스냅샷 업데이트 (diff 검토 후 수락)
```

```js
// Jest 스냅샷 테스트 (예: React 컴포넌트)
test('renders correctly', () => {
  const tree = render(<Button label="Click" />).toJSON();
  expect(tree).toMatchSnapshot();    // 저장된 스냅샷과 비교
});
```

## 용도와 이점

```text
✓ 의도하지 않은 변경 감지 — 출력이 예상치 못하게 변경되면 표시 (UI, 직렬화 데이터)
✓ 작성 빠름 — 복잡한 출력에 수동 어서션 불필요; 기대 결과를 자동 캡처
✓ UI 컴포넌트에 좋음 (예상치 못한 렌더링 변경 포착), 설정, 큰 데이터 구조
```

## 한계 (신중히 사용)

```text
⚠️ 스냅샷은 정확성을 검증하지 않음 — 존재하는 출력을 (틀려도) 캡처;
   변경만 감지, 출력이 옳은지는 아님
⚠️ 스냅샷 무작정 업데이트 (검토 없이 jest -u) → 목적을 무력화 (깨진 출력 수락)
   — 흔한 나쁜 습관
⚠️ 크고/깨지기 쉬운 스냅샷 → 자주 변경, 도장 찍듯 통과, 가치 낮음
→ 변경 감지에 사용; 스냅샷을 작고 집중되게 유지; diff 검토;
   그것에만 의존하지 않기 (동작에 대한 실제 어서션과 결합).
```

## 왜 중요한가

스냅샷 테스트를 이해하는 것은 가치가 있습니다. 이는 (특히 UI에) **흔히 쓰이는 기법**으로, 잘 적용하면 유용하지만 오용하면 문제가 되므로, 그 가치와 한계를 모두 이해하는 것이 중요한 실용 지식입니다.

스냅샷 테스트 — 출력(흔히 렌더링된 UI 컴포넌트나 데이터 구조)을 캡처하고 이후 실행을 저장된 스냅샷에 대해 비교 — 는 **의도하지 않은 변경을 감지하는 데 유용**합니다: 출력이 예상치 못하게 변경되면 표시하고(우발적 UI 렌더링 변경이나 데이터 구조 변경 포착), **작성이 빠르며**(복잡한 출력의 모든 세부를 수동 단언하지 않고 기대 출력을 자동 캡처), UI 컴포넌트, 설정, 큰 데이터 구조에 적합합니다.

이런 이점들이 특히 UI 테스팅에서의 인기를 설명합니다.

그러나 **한계를 이해하는 것이 결정적으로 중요**하여 잘 사용할 수 있습니다: 스냅샷은 **정확성을 검증하지 않음** — 존재하는 출력을 (틀려도) 캡처하여 *변경*만 감지하고 *옳음*은 감지하지 않음 — 그래서 스냅샷이 버그가 있는 출력을 고정할 수 있습니다.

**가장 큰 함정은 스냅샷을 무작정 업데이트하는 것**(diff를 검토하지 않고 업데이트 명령 실행)으로, 잠재적으로 깨진 출력을 수락하여 목적을 무력화합니다 — 흔한 나쁜 습관입니다.

자주 변경되는 크고 깨지기 쉬운 스냅샷은 도장 찍듯 통과되고 거의 가치를 제공하지 않습니다.

적절한 사용 — 변경 감지용, 스냅샷을 작고 집중되게 유지, **스냅샷 diff를 신중히 검토**, 그것에만 의존하지 않기(실제 동작 어서션과 결합) — 을 이해하는 것은 흔한 오용을 피하는 성숙한 판단을 반영합니다.

스냅샷 테스트는 (특히 UI에) 널리 쓰이고 변경 감지에 유용하지만 쉽게 오용되며(틀린 출력 고정, 무작정 업데이트), 그 가치와 중요한 한계를 모두 이해하는 것이 잘 사용하게 해주므로, 스냅샷 테스트를 이해하는 것은 가치 있고 실용적인 지식입니다. 이는 올바르게 이해해야 하는 흔한 기법으로, 그 한계(정확성이 아닌 변경 감지)와 적절한 사용(무작정 업데이트가 아닌 diff 검토)을 이해하는 것이 기법 자체만큼 중요하며, 건전한 테스팅 판단을 반영합니다.