JSON Diff (Bandingkan)

Apa itu 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 }]

Fitur Utama

Contoh

{"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}]}

Cara Penggunaan

1. 1

   Tempelkan kedua dokumen JSON

   Tempelkan JSON asli (kiri) dan yang dimodifikasi (kanan). Live diff dirender saat Anda mengetik; input besar (>200 KB) beralih ke tombol Diff manual.

2. 2

   Filter kebisingan

   Klik preset (Timestamps / IDs / Trace) atau tempelkan pola Extended JSON Pointer ke Ignore paths untuk menghapus field yang tidak relevan.

3. 3

   Pilih tampilan yang Anda butuhkan

   Side-by-Side untuk review oleh manusia, JSON Patch (RFC 6902) untuk ops yang dapat diterapkan oleh mesin. Gunakan Share Link untuk mengirim konfigurasi ke rekan kerja.

Jebakan Umum dalam 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

Kasus Penggunaan Umum

Regresi API Response

Bandingkan response staging vs produksi; abaikan timestamp dan request ID untuk menampilkan hanya perubahan payload yang bermakna.

Kegagalan Snapshot Test CI

Tempelkan actual vs expected dari snapshot Jest/Vitest yang gagal. Filter kebisingan dan temukan perubahan nyata dalam hitungan detik.

Konflik package-lock / yarn.lock

Selesaikan merge conflict dengan menyelaraskan dependensi berdasarkan nama; urutan key dan field yang tidak relevan tidak lagi menjadi kebisingan.

Audit K8s / Helm Values

Cocokkan envs, volumeMounts, dan ports berdasarkan nama. Tangkap perubahan urutan yang tidak disengaja vs pengeditan konfigurasi nyata.

Cakupan Terjemahan i18n

Diff en.json terhadap zh.json secara struktural untuk menemukan key terjemahan yang hilang atau berlebih tanpa kebisingan nilai.

Review Plan Terraform / CDK

Bandingkan output plan antar run; numeric tolerance menangani aritmetika floating-point, ignore paths menghapus ARN dan timestamp.

Detail Teknis

Output Patch Sesuai RFC 6902

Menghasilkan ops JSON Patch yang valid (add/remove/replace) dengan path RFC 6901. Diverifikasi terhadap fast-json-patch@3.x dan package npm rfc6902.

Traversal Iteratif

Traversal dengan explicit-stack (tanpa rekursi) dibatasi pada 100.000 node dan kedalaman 64 untuk mencegah stack overflow pada input yang berpotensi menyerang.

Kesamaan Numerik Object.is

Numeric tolerance default adalah 0 — menggunakan Object.is sehingga -0 dan +0 dibedakan. Set tolerance > 0 untuk kesamaan berbasis epsilon.

Praktik Terbaik

Filter Sebelum Review

Tambahkan Ignore paths terlebih dahulu (timestamp, ID, trace field), lalu baca diff. Mereview diff yang berisik melatih mata untuk melewatkan — dan melewatkan — perubahan nyata.

Match-by-Key untuk Set Logis

Jika array Anda merepresentasikan set yang tidak berurutan (envs, users, dependencies), gunakan Match by key. Sequential diff pada set logis hampir selalu salah.

Bagikan Link, Bukan Input

Gunakan Share Link untuk mengirim konfigurasi filter ke kolega — jangan pernah menempelkan JSON sensitif ke dokumen bersama. URL hanya berisi konfigurasi.

Pertanyaan yang Sering Diajukan