Cara Diff dan Membandingkan Dokumen JSON (Tanpa Kehilangan Akal)

Mengapa diff teks menyesatkan Anda pada JSON

Alat diff teks membandingkan baris demi baris. Jika serializer JSON mengubah urutan key, beralih dari indentasi dua spasi ke empat spasi, atau menulis 1.50 alih-alih 1.5, diff teks menandai setiap baris sebagai berubah — padahal data yang diurai identik. Diff struktural mem-parse kedua dokumen lebih dulu, lalu membandingkan nilai hasilnya: ia benar melaporkan nol perbedaan untuk object yang urutannya berubah tetapi isinya setara.

// Version A
{"name": "Ada", "role": "admin"}

// Version B
{
  "role": "admin",
  "name": "Ada"
}

Diff berbasis baris pada pasangan ini menampilkan semuanya sebagai ditulis ulang. Diff struktural benar melaporkan tidak ada perubahan — key yang sama, nilai yang sama, hanya urutan key dan formatan yang berbeda.

Apa yang sebenarnya dilaporkan diff struktural

Diff JSON yang baik mengategorikan setiap perbedaan menurut jenisnya alih-alih sekadar menampilkan teks sebelum/sesudah mentah: added — key yang hadir di dokumen baru tetapi tidak di yang lama. removed — key yang hadir di dokumen lama tetapi hilang dari yang baru. changed — key yang hadir di keduanya, tetapi dengan nilai berbeda. type-changed — nilai yang berganti tipe data sepenuhnya (string menjadi number, object menjadi array), yang sering kali sinyal lebih serius daripada perubahan nilai sederhana karena bisa merusak konsumen yang mengasumsikan bentuk tetap.

Di mana diff JSON benar-benar dipakai

Regression testing API: tangkap respons yang diketahui baik, lalu diff setiap respons baru terhadapnya di CI. Diff struktural menandai perubahan kontrak nyata (field diganti nama atau dihapus) sambil mengabaikan derau kosmetik seperti urutan key atau nilai timestamp yang memang diharapkan berubah pada setiap run.

Deteksi config drift: bandingkan konfigurasi live layanan yang ter-deploy terhadap versi yang di-check-in ke source control untuk menangkap perubahan manual di luar jalur sebelum mereka memicu insiden.

Audit trail: simpan ringkasan diff di samping snapshot "sebelum" dan "sesudah" setiap kali record berubah, agar reviewer melihat persis field mana yang bergeser alih-alih membaca ulang dua dokumen penuh berdampingan.

Resolusi merge conflict: ketika dua branch sama-sama memodifikasi konfigurasi JSON bersama, diff struktural tiap branch terhadap ancestor bersama membuat jauh lebih jelas key spesifik mana yang benar-benar konflik dibanding yang hanya punya perubahan tak berhubungan di dekatnya.

Mengapa array adalah bagian tersulit dari diff JSON

Object ter-diff dengan bersih karena key diberi nama — "role" di dokumen A selalu berkorespondensi dengan "role" di dokumen B. Array tidak punya nama, hanya posisi, jadi alat diff harus memutuskan apakah item pada indeks berbeda itu "berpindah" atau "berbeda". Menyisipkan satu item di awal daftar menggeser setiap indeks berikutnya satu langkah — diff naif indeks-demi-indeks melaporkan seluruh sisa array sebagai berubah, padahal sungguhnya hanya satu item ditambahkan. Alat diff yang lebih baik memakai heuristik pencocokan (sering berbasis field id yang stabil, jika ada pada item array) untuk benar mendeteksi penyisipan, penghapusan, dan penyusunan ulang alih-alih memperlakukan setiap indeks bergeser sebagai perubahan.