JSON Diff 비교

JSON Diff란 무엇인가요?

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

주요 기능

예시

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

사용 방법

1. 1

   두 JSON 문서 붙여넣기

   원본(왼쪽)과 수정본(오른쪽) JSON을 붙여넣으세요. 입력하는 동안 라이브 Diff가 렌더링됩니다; 대용량 입력(>200 KB)은 수동 Diff 버튼으로 전환됩니다.

2. 2

   노이즈 필터링

   프리셋(Timestamps / IDs / Trace)을 클릭하거나 Ignore paths에 Extended JSON Pointer 패턴을 붙여넣어 관련 없는 필드를 제거하세요.

3. 3

   필요한 뷰 선택

   사람이 검토할 때는 나란히 보기, 자동화 적용에는 JSON Patch (RFC 6902). Share Link로 팀원에게 설정을 전송하세요.

일반적인 Diff 함정

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

주요 활용 사례

API 응답 회귀 테스트

스테이징과 프로덕션 응답을 비교하고, 타임스탬프와 요청 ID를 무시하여 의미 있는 페이로드 변경만 노출합니다.

CI 스냅샷 테스트 실패

실패한 Jest/Vitest 스냅샷에서 실제값과 기대값을 붙여넣으세요. 노이즈를 필터링하고 몇 초 만에 실제 변경 사항을 찾습니다.

package-lock / yarn.lock 충돌

이름으로 의존성을 정렬하여 병합 충돌을 해결합니다; 키 순서와 관련 없는 필드가 더 이상 노이즈가 되지 않습니다.

K8s / Helm Values 감사

이름으로 envs, volumeMounts, ports를 매칭합니다. 의도치 않은 순서 변경과 실제 설정 편집을 구별합니다.

i18n 번역 커버리지

en.json과 zh.json을 구조적으로 Diff 비교하여 값 노이즈 없이 누락되거나 추가된 번역 키를 찾습니다.

Terraform / CDK Plan 검토

실행 간 plan 출력을 비교합니다; 숫자 허용 오차로 부동소수점 연산을 처리하고, ignore paths로 ARN과 타임스탬프를 제거합니다.

기술 세부사항

RFC 6902 호환 패치 출력

RFC 6901 경로로 유효한 JSON Patch ops(add/remove/replace)를 생성합니다. fast-json-patch@3.x 및 rfc6902 npm 패키지에 대해 검증되었습니다.

반복적 순회

명시적 스택 순회(재귀 없음)로 적대적 입력에서 스택 오버플로를 방지하기 위해 최대 100,000개 노드와 깊이 64로 제한합니다.

Object.is 숫자 동등성

기본 숫자 허용 오차는 0으로 Object.is를 사용하여 -0과 +0을 구별합니다. 엡실론 기반 동등성을 위해 허용 오차를 0보다 크게 설정하세요.

모범 사례

검토 전에 필터링

먼저 Ignore paths를 추가하고(타임스탬프, ID, 트레이스 필드) Diff를 읽으세요. 노이즈가 많은 Diff를 검토하면 눈이 실제 변경 사항을 놓치도록 훈련됩니다.

논리적 집합에는 키로 매칭

배열이 비순서 집합(envs, users, dependencies)을 나타내면 키로 매칭하세요. 논리적 집합에서 순차 Diff는 거의 항상 잘못됩니다.

입력값이 아닌 링크 공유

동료에게 필터 설정을 보낼 때 Share Link를 사용하세요 — 민감한 JSON을 공유 문서에 붙여넣지 마세요. URL에는 설정만 포함됩니다.

자주 묻는 질문