03 / PANDUAN
Format dan periksa JSON sebelum Anda meninjaunya
Rutinitas peninjau untuk payload API dan berkas konfigurasi: pretty-print dulu, periksa struktur sebagai pohon, dan bandingkan dua dokumen secara deterministik—tanpa mengirim data ke mana pun.
Mengapa pemformatan lebih dulu
JSON terminifikasi dibuat untuk mesin: satu baris, tanpa indentasi, kunci dalam urutan apa pun yang dihasilkan serializer. Meminta mata Anda meninjau dinding itu adalah cara izin yang dihapus, flag yang terbalik, atau endpoint tak terduga lolos.
Pretty-printer juga merupakan pemeriksaan validitas termurah yang Anda miliki. Dokumen yang gagal diparse memang tidak akan pernah berperilaku baik di produksi, dan mengetahuinya di tab peninjauan jauh lebih baik daripada mengetahuinya dari log deployment.
- Keterbacaan sajaPemformatan adalah transformasi keterbacaan: ia mengubah spasi dan jeda baris, tidak pernah mengubah data, sehingga salinan terformat selalu aman ditinjau terhadap aslinya.
- Kedalaman adalah sinyalIndentasi yang konsisten memperlihatkan kedalaman bersarang sekejap mata, dan kedalaman adalah tempat kesalahan konfigurasi bersembunyi—opsi yang diletakkan satu level terlalu dalam begitu saja diabaikan.
- Kirim bentuk yang diharapkanTinjau salinan terformat, tetapi kirim bentuk apa pun yang diharapkan sistem; pretty-printing untuk manusia, bukan untuk jaringan.
Periksa pohonnya, bukan hanya teksnya
Tampilan pohon menjawab pertanyaan yang benar-benar diajukan peninjau—kunci apa yang ada, apa tipe setiap nilai, sedalam apa strukturnya—tanpa memindai tanda kurung. Teks mentah tidak menjawab satu pun dengan cepat.
JSON Tree Viewer mem-parse secara eksplisit: tidak ada yang dirender sampai Anda menekan Parse JSON, dan masukan tidak valid mendapatkan kesalahan berlokasi dengan petunjuk perbaikan alih-alih kegagalan senyap. Hasilnya terbuka sebagai pohon yang dapat diluaskan dengan tipe dan jumlah per node, dan tab Formatted menampilkan dokumen ternormalisasi dengan indentasi pilihan Anda.
Ringkasan parse melaporkan jumlah node dan kedalaman maksimum, pemeriksaan kewajaran cepat terhadap seharusnya isi payload. Kunci prototipe cadangan ditolak, sehingga payload jahat tidak dapat menyamar sebagai data polos saat Anda memeriksanya.
Pohon juga meratakan percakapan dalam tinjauan: “elemen ketiga items memiliki price null” adalah komentar yang bisa diverifikasi siapa pun dalam hitungan detik, sementara offset byte ke baris terminifikasi bukan.
Buka JSON Tree ViewerDiff dua dokumen secara deterministik
Membandingkan dua dokumen JSON dengan mata gagal begitu urutan kunci berubah. Diff struktural mem-parse kedua sisi dan melaporkan apa yang benar-benar berubah—nilai yang ditambah, dihapus, dan diubah—terlepas dari urutan atau spasi.
Text & JSON Diff menawarkan tiga mode: baris, karakter, dan JSON. Mode JSON adalah yang deterministik untuk tinjauan: kedua dokumen diparse lalu dibandingkan nilai demi nilai, sehingga kunci yang diurutkan ulang dan spasi yang diformat ulang dilaporkan identik dengan benar.
Untuk teks non-JSON, mode baris dan karakter menyertakan pengalih abaikan-spasi dan normalisasi jeda baris, dan ringkasannya menghitung penambahan, penghapusan, serta perubahan. Gunakan mode JSON untuk payload dan konfigurasi; kembali ke mode baris ketika salah satu sisi sama sekali bukan JSON valid.
Determinisme penting melampaui kenyamanan. Ketika dua peninjau menjalankan perbandingan yang sama, mereka harus mendapatkan jawaban yang sama—kalau tidak, tinjauan berubah menjadi negosiasi tentang perkakas alih-alih keputusan tentang perubahan.
Buka Text & JSON DiffKenali batas runtime lokal
Ini adalah runtime lokal dengan plafon eksplisit, berukuran untuk payload tinjauan alih-alih pemrosesan data massal. Mengetahui plafon memberi tahu Anda kapan harus beralih ke perkakas desktop.
Plafon ada karena parsing dan diff berjalan di tab yang sama dengan yang sedang Anda baca; batas yang jujur lebih baik daripada halaman beku, dan ruang kerja melaporkan batas yang terlampaui sebagai kesalahan eksplisit, bukan pemotongan diam-diam.
- Plafon viewerJSON Tree Viewer menerima masukan hingga 256 KiB, empat puluh tingkat bersarang, dan sepuluh ribu node—lebih dari cukup untuk respons API atau berkas konfigurasi.
- Plafon diffText & JSON Diff membandingkan hingga 256 KiB per sisi dan melaporkan paling banyak sepuluh ribu rekaman perbedaan sebelum menyatakan perbandingan terlalu kompleks.
- Di luar perambanEkspor yang lebih besar—dump basis data, arsip log, fixture yang dihasilkan—termasuk ranah editor desktop atau alat baris perintah, bukan tab peramban.
Daftar periksa tinjauan lima menit
Rutinitas singkat yang menangkap sebagian besar masalah payload sebelum mencapai produksi.
Jalankan daftar periksa pada data sampel produsen maupun payload langsung; fixture yang tidak cocok dengan kenyataan membatalkan tinjauan sama pastinya seperti bug.
- ParseFormat dan parse dulu: pastikan dokumen valid dan lihat sekilas jumlah node serta kedalamannya terhadap ekspektasi.
- PeriksaPeriksa pohonnya: periksa tipe di daun—pengenal numerik yang tiba sebagai string adalah bug integrasi klasik.
- DiffDiff terhadap versi baik-terakhir-diketahui dalam mode JSON, dan baca setiap perubahan yang dilaporkan sebelum menyetujui.
Biarkan payload tetap di perangkat Anda
Payload tinjauan sering berisi rekaman pelanggan, token, atau URL internal. Viewer lokal menjaga materi itu di dalam tab: teks diparse oleh kode yang berjalan di perangkat Anda dan tidak pernah dikirim sebagai bagian dari operasi.
Batas itulah yang membuat alat-alat ini dapat dipakai dengan payload staging nyata selama tinjauan. Ia tidak menghapus kewajiban Anda sendiri: ekspor yang diunduh, isi papan klip, dan tangkapan layar pohon tetap menjadi tanggung jawab Anda setelah meninggalkan ruang kerja.
Jika Anda harus membagikan fragmen payload dalam tinjauan, tempel kutipan terkecil yang menunjukkan masalah dan redaksi pengenal terlebih dahulu—disiplin yang sama yang diminta kanal dukungan.
Mengapa inspeksi lokal adalah klaim yang kredibel.
Pelajari cara runtime peramban menjaga data di perangkat, dan cara memverifikasi jalur data alat apa pun yang Anda gunakan untuk meninjau.