JSON tree view vs. table view: mana yang benar-benar membantu debugging lebih cepat

Kebanyakan JSON viewer memberi pilihan antara tree view (bertingkat, bisa dilipat, satu nilai per baris) dan table view (baris dan kolom, gaya spreadsheet). Keduanya terlihat seperti dua tampilan berbeda dari data yang sama, jadi wajar kalau tergoda untuk asal pakai yang dibuka default oleh tool. Padahal itu insting yang keliru — kedua tampilan ini sebenarnya dioptimalkan untuk bentuk data dan tugas debugging yang berbeda, dan salah pilih akan benar-benar membuang waktu.

Kelebihan masing-masing tampilan

Tree view mencerminkan struktur asli JSON: setiap object dan array menjadi node yang bisa dilipat, setiap nilai daun (leaf value) berada di barisnya sendiri di sebelah key-nya. Ini pilihan yang tepat ketika:

Struktur itu sendiri yang sedang Anda debug — Anda mencoba mencari di mana letak sebuah nilai di dalam object yang bertingkat dalam, atau memastikan sebuah field memang ada.
Datanya tidak seragam — object-object yang berbeda dalam satu response memiliki set key yang berbeda, field opsional, atau kedalaman nesting yang bervariasi. Table tidak bisa merepresentasikan ini dengan rapi; tree bisa.
Anda perlu melihat relasi parent-child secara eksplisit, misalnya menelusuri object tertentu itu milik array yang mana.

Table view meratakan array of objects menjadi baris dan kolom, satu kolom per key. Ini unggul ketika:

Anda punya array berisi object yang seragam — daftar user, order, atau log entry yang semuanya memiliki bentuk yang sama.
Anda sedang mencari outlier — null di tempat yang seharusnya angka, typo pada nilai enum, field yang hilang di satu baris saja. Table membuat outlier langsung terlihat secara visual karena mata Anda bisa menyusuri satu kolom dari atas ke bawah; tree justru mengubur anomali yang sama di dalam puluhan node yang harus dibuka satu per satu.
Anda ingin sesuatu yang lebih mendekati mental model spreadsheet — mengurutkan data, atau melihat sekilas baris mana saja yang punya nilai sama.

Akibat konkret kalau salah pilih

Buka response API yang bertingkat dalam (auth token di dalam object user di dalam object session) dalam table view, dan Anda akan mendapati tabel yang sebagian besar selnya hanya bertuliskan [Object] atau [Array] — proses perataan (flattening) tidak punya tempat untuk menampung struktur bertingkat itu, jadi ia runtuh menjadi placeholder yang tidak berguna dan tetap harus Anda klik satu per satu — hasilnya jelas lebih buruk dibanding langsung memakai tree view sejak awal.

Buka array berisi 200 baris log entry yang hampir identik dalam tree view, dan Anda akan mendapati 200 node terpisah yang harus dibuka satu per satu hanya untuk menemukan satu baris di mana status ternyata bernilai null — pemindaian yang hanya butuh dua detik di table view bisa memakan waktu bermenit-menit klik-klik di tree view.

Aturan sederhana

Tanyakan satu hal terlebih dahulu: apakah variasi menarik itu terjadi antar-sibling, atau menyusuri kedalaman (depth)?

Kalau Anda membandingkan banyak item yang mirip satu sama lain (antar-sibling) — pakai table view.
Kalau Anda menelusuri sebuah nilai turun ke dalam struktur bertingkat (menyusuri depth) — pakai tree view.

Untuk debugging JSON sehari-hari yang intinya hanya butuh data yang terbaca dan valid secara sintaks — mengecek indentasi, memastikan kurung siku dan kurawal seimbang, mencari koma berlebih di akhir — sebenarnya kedua tampilan ini tidak mutlak diperlukan. Versi JSON mentah yang sudah diberi indentasi rapi (pretty-printed) — yang dihasilkan oleh JSON formatter — sudah cukup menampilkan struktur dengan jelas untuk sebagian besar pengecekan cepat, dan lebih cepat didapat dibanding harus mengganti mode viewer ke tampilan tertentu. Gunakan tree atau table view khusus saat data terlalu besar atau terlalu bertingkat untuk sekadar dibaca dari atas ke bawah.