Cara Membandingkan Dua File JSON (dan Mengapa Diff Teks Biasa Menyesatkan)
Bandingkan dua file JSON dan lihat kunci mana yang ditambah, dihapus, atau diubah. Mengapa diff teks berisik, cara array dipasangkan, dan apa yang bisa diabaikan.
Diperbarui 7 November 2026Baca 7 menit
Untuk membandingkan dua file JSON, buka pembanding Diff JSON, letakkan satu file di tiap sisi (atau tempel teksnya), lalu baca daftar perbedaannya. Tiap perbedaan ditandai ditambahkan, dihapus, diubah, atau tipe berubah, lengkap dengan jalur tepat ke nilainya. Alat ini membandingkan data, bukan teks, sehingga kunci yang urutannya berbeda dan indentasi yang berbeda tidak muncul sebagai perubahan. Itulah alasan utama memakainya dibanding diff teks biasa.
Mengapa diff teks untuk JSON begitu berisik
Perbandingan teks bekerja baris demi baris. JSON tidak peduli soal baris. Kedua dokumen ini berisi data yang persis sama, tetapi diff teks menandai setiap baris sebagai berbeda: yang satu ditulis dalam satu baris, yang lain berindentasi empat spasi, dan kuncinya muncul dalam urutan berbeda.
| Apa yang berbeda | Kata diff teks | Kata datanya |
|---|---|---|
| Indentasi (2 spasi, 4, atau satu tab) | Setiap baris berubah | Tidak ada yang berubah |
| Seluruh file di-minify jadi satu baris | Satu baris diganti baris lain | Tidak ada yang berubah |
| Kunci dalam urutan berbeda | Baris berpindah atau ditulis ulang | Tidak ada yang berubah: objek tidak punya urutan |
| 1 ditulis sebagai 1.0 | Baris berubah | Angka yang sama |
| Harga dari 9,99 menjadi 10,99 | Satu baris berubah | Satu nilai berubah |
Baris terakhir adalah yang Anda pedulikan, dan dalam diff teks ia terkubur di bawah empat baris pertama. Banyak API mengembalikan kunci dalam urutan berbeda di setiap panggilan, dan banyak program menulis ulang indentasi saat menyimpan file, jadi kebisingan itu hal biasa, bukan pengecualian.
Membandingkan dua file JSON, langkah demi langkah
Tambahkan dokumen sisi kiri
Buka pembanding Diff JSON. Tempel dokumen asli ke kotak Kiri (asli), atau letakkan file .json di area penjatuhan. Alat ini juga membuka file .jsonc, .geojson, .map, dan .txt.
Tambahkan dokumen sisi kanan
Tempel atau letakkan versi yang diubah ke Kanan (diubah). Jika Anda menjatuhkan kedua file sekaligus, keduanya dipasangkan menurut nama, sehingga billing.before.json dan billing.after.json masuk ke sisi yang benar. Gunakan Tukar sisi jika posisinya terbalik.
Baca perbedaannya
Perbandingan berjalan sambil Anda mengetik. Pilih Berdampingan, Sebaris, atau Menurut jalur. Ringkasan menunjukkan berapa yang ditambah, dihapus, dan diubah, dan tombol Perubahan berikutnya serta Sebelumnya melompat di antaranya. Gunakan filter untuk menampilkan hanya yang ditambah, dihapus, diubah, atau perubahan tipe.
Atur apa yang dihitung sebagai perbedaan
Buka pengaturan perbandingan untuk mengabaikan urutan array, huruf besar-kecil, atau spasi, menetapkan toleransi angka, atau melewati kunci yang selalu berubah. Bagian berikutnya menjelaskan masing-masing.
Ekspor jika Anda butuh catatan
Salin ringkasan menaruh daftar perubahan sederhana di clipboard. Unduh patch JSON menghasilkan file standar yang mengubah dokumen kiri menjadi dokumen kanan. Unduh Markdown menghasilkan laporan yang bisa ditempel ke tiket atau pull request.
Bandingkan dua dokumen dan lihat setiap nilai yang ditambah, dihapus, dan diubah menurut jalur. Gratis: satu pasang sekali jalan, hingga 10 MB per sisi, dengan semua opsi dan ekspor disertakan. Berjalan di perangkat Anda, bukan di server kami.
Bandingkan dua file JSONIsi laporan: ditambahkan, dihapus, diubah
Alat ini menelusuri kedua dokumen bersamaan dan melaporkan setiap perbedaan beserta lokasinya. Objek dibandingkan kunci demi kunci, di kedalaman berapa pun. Kunci yang hanya ada di kanan ditambahkan. Kunci yang hanya ada di kiri dihapus. Kunci yang ada di kedua sisi dengan nilai berbeda diubah. Nilai yang jenisnya berubah, misalnya teks "3" menjadi angka 3, dilaporkan terpisah sebagai tipe berubah, karena itulah perubahan yang paling mungkin merusak apa pun yang membaca file berikutnya.
Lokasi ditulis sebagai jalur. Di Menurut jalur Anda melihat letak tiap perubahan, misalnya nama item kedua dalam daftar pengguna. Patch yang diekspor memakai bentuk standar JSON Pointer (/users/1/name), yang tetap tidak ambigu bahkan ketika sebuah kunci memuat titik atau garis miring.
- Angka dibandingkan menurut nilainya, jadi 1, 1.0, dan 1e0 adalah angka yang sama dan tidak dilaporkan.
- Mengubah urutan kunci dalam objek tidak pernah dianggap perubahan.
- Tingkat paling atas boleh apa saja yang diizinkan JSON: objek, array, atau bahkan satu string atau angka.
- Jika sebuah dokumen mendeklarasikan kunci yang sama dua kali, alat ini memberi peringatan, karena parser diam-diam hanya menyimpan nilai terakhir dan perbedaan pada yang sebelumnya tidak terlihat.
Cara array dibandingkan
Array adalah tempat perbandingan JSON sering salah. Jika dua daftar dibandingkan ketat posisi demi posisi, menambah satu item di depan membuat semua item sesudahnya tampak berbeda. Alat ini menghindarinya dengan menyejajarkan item lebih dulu, dan menampilkan strategi yang dipakai di samping ringkasan.
| Strategi | Kapan dipakai | Cocok untuk |
|---|---|---|
| Menurut id | Anda menyebut sebuah bidang di Pasangkan item menurut bidang dan setiap item punya nilai unik di sana | Rekaman dari API yang datang dalam urutan berbeda |
| Menurut subsekuens bersama terpanjang | Bawaan | Daftar yang itemnya disisipkan atau dihapus |
| Sebagai himpunan | Abaikan urutan array aktif | Tag, izin, apa pun yang urutannya tidak berarti |
| Menurut posisi | Kedua daftar hampir tidak punya kesamaan | Daftar yang memang diganti |
Memasangkan menurut id adalah pilihan untuk daftar rekaman. Ketik nama bidangnya (id yang paling umum) dan daftar yang urutannya berubah dibaca sebagai berubah urutan, dengan hanya rekaman yang benar-benar berubah yang dilaporkan. Alat ini memakai bidang itu hanya jika setiap item memilikinya dan tidak ada nilai yang berulang. Jika tidak, hasilnya pasangan yang rapi tetapi salah, jadi alat ini kembali ke bawaan alih-alih menebak.
Abaikan kebisingan: kunci, jalur, huruf, dan angka
Perbandingan ketat adalah bawaannya: setiap nilai, tipe, dan posisi dalam array harus cocok. Tiap pengaturan melonggarkan tepat satu hal, dan laporan yang diekspor mencatat mana yang aktif.
- Kunci yang diabaikan: tulis nama seperti updatedAt atau requestId, dipisahkan koma. Kunci itu dilewati di mana pun muncul, di kedalaman berapa pun. Inilah yang mengubah dua cuplikan API menjadi diff yang terbaca.
- Jalur yang diabaikan: lewati satu lokasi, dengan * untuk satu tingkat dan ** untuk sembarang jumlah. /users/*/lastSeen melewati bidang itu untuk setiap pengguna.
- Abaikan huruf besar-kecil dan Abaikan spasi: untuk label yang gayanya berubah, atau deskripsi yang dibungkus ulang.
- Toleransi angka: seberapa dekat dua angka agar dianggap sama. Dengan toleransi 0,0001, kebisingan pembulatan desimal hilang sementara perubahan harga yang sebenarnya tetap terlihat.
- Izinkan komentar dan koma penutup: untuk file konfigurasi yang ditulis sebagai JSONC.
Pemakaian umum: perubahan API dan konfigurasi yang melenceng
Untuk API yang berubah, simpan respons sebelum dan sesudah, masukkan bidang yang selalu berubah (cap waktu, id permintaan, etag) ke kunci yang diabaikan, dan yang tersisa adalah perubahan bentuk yang sebenarnya. Untuk konfigurasi yang melenceng antara dua lingkungan, seperti staging dan produksi, muat kedua file dan lihat Menurut jalur: daftarnya menunjukkan tepat pengaturan mana yang berbeda, dan tidak lebih. Untuk migrasi atau ekspor, bandingkan file lama dan baru lalu unduh laporan Markdown sebagai catatan apa yang berpindah.
Jika Anda ingin tetap memakai diff teks biasa, misalnya di dalam alat tinjauan kode, buat dulu kedua file tampak sama: jalankan masing-masing lewat pemformat JSON dengan indentasi yang sama, dan taruh kunci dalam satu urutan dengan urutkan kunci JSON. Mengurutkan kunci hanya memindahkan kunci, dan nilainya tidak disentuh. Itu menghilangkan sebagian besar kebisingan teks, tetapi tidak bisa melakukan apa yang dilakukan alat diff pada array, toleransi, atau bidang yang diabaikan.
Batas dan hal yang bisa salah
- Ukuran: Gratis membandingkan satu pasang sekali jalan, hingga 10 MB per sisi. Pro menaikkan ukuran sesuai kemampuan perangkat Anda dan membandingkan hingga 50 pasang sekaligus, dipasangkan menurut nama file, dengan semua laporan dan patch dalam satu ZIP. File di atas batas gratis ditolak dengan menyebut ukuran sebenarnya dan tautan ke minifier, karena JSON yang sudah diformat sering kali sebagian besar adalah indentasi.
- Format lain: file YAML, XML, CSV, dan Excel ditolak di pintu masuk dengan tautan ke konverter yang tepat, seperti YAML ke JSON. Konversi dulu, baru bandingkan.
- "Tidak ada perbedaan" terasa janggal: periksa apakah pengaturan abaikan, toleransi angka yang tinggi, atau peringatan kunci ganda menjelaskannya.
- Terlalu banyak perbedaan: di atas 100.000 daftar berhenti bertambah, tetapi totalnya tetap tepat, dan halaman menyebutkan bahwa daftar dipotong.
- Daftar sangat besar dalam dua urutan berbeda: sebut bidang id, atau aktifkan Abaikan urutan array, daripada membaca ribuan perpindahan.
Perbandingan berjalan di perangkat Anda, bukan di server kami, jadi kredensial dan data pelanggan dalam sebuah payload tidak diunggah untuk dibandingkan. Untuk gambaran singkat perbedaan JSON dengan format data lain, lihat JSON vs CSV vs XML.
Pertanyaan umum
Bagaimana cara membandingkan dua file JSON online?
Buka pembanding Diff JSON, letakkan satu file di tiap sisi atau tempel teksnya, lalu baca daftar nilai yang ditambah, dihapus, dan diubah. Perbandingan berjalan sambil mengetik. Paket gratis mencakup satu pasang hingga 10 MB per sisi.
Apakah penting jika urutan kuncinya berbeda?
Tidak. Objek tidak punya urutan, jadi objek yang urutannya diubah dibandingkan sebagai identik. Hanya array yang punya urutan, dan Anda bisa mengaktifkan Abaikan urutan array jika itu pun tidak penting.
Bagaimana membandingkan dua array JSON saat itemnya berpindah tempat?
Ketik nama bidang unik, biasanya id, di Pasangkan item menurut bidang. Item lalu disejajarkan menurut nilai itu, bukan menurut posisi, sehingga daftar yang urutannya berubah hanya menampilkan rekaman yang benar-benar berubah. Atau aktifkan Abaikan urutan array.
Bisakah saya mengabaikan bidang seperti cap waktu?
Bisa. Tulis nama kunci di Kunci yang diabaikan, misalnya updatedAt, requestId. Kunci itu dilewati di kedalaman berapa pun. Untuk melewati satu lokasi saja, gunakan Jalur yang diabaikan, yang menerima karakter pengganti * dan **.
Bisakah saya membandingkan JSON dengan komentar, seperti file konfigurasi?
Bisa. Aktifkan Izinkan komentar dan koma penutup, atau letakkan file .jsonc, yang mengaktifkannya untuk Anda. YAML dan XML tidak dibuka langsung: konversi dulu ke JSON.
Bisakah saya menyimpan perbedaannya?
Bisa, dengan tiga cara, semuanya di paket gratis: menyalin ringkasan sederhana, mengunduh patch JSON RFC 6902, atau mengunduh laporan Markdown. Pro menambahkan kelompok hingga 50 pasang dalam satu ZIP.