JSON prikaz stabla ili tablice: koji vam stvarno pomaže brže debugirati

Većina JSON preglednika nudi izbor između prikaza stabla (ugniježđeno, sklopivo, jedna vrijednost po retku) i prikaza tablice (redci i stupci, poput proračunske tablice). Izgledaju kao dva ruha na istim podacima, pa je primamljivo uzeti onaj koji alat otvori prema zadanim postavkama. To je pogrešan instinkt — dva prikaza zapravo su optimizirana za različite oblike podataka i različite zadatke debugiranja, a odabir pogrešnog za posao košta vas stvarnog vremena.

U čemu je koji prikaz stvarno dobar

Prikaz stabla odražava stvarnu strukturu JSON-a: svaki objekt i niz je sklopivi čvor, svaka listna vrijednost stoji u svom retku pored svog ključa. Ovo je pravi izbor kada:

• Debugirate samu strukturu — pokušavate pronaći gdje u duboko ugniježđenom objektu neka vrijednost živi, ili potvrditi da polje uopće postoji.
• Podaci su nepravilni — različiti objekti u istom odgovoru imaju različite skupove ključeva, opcionalna polja ili promjenjivu dubinu ugnježđivanja. Tablica to ne može čisto prikazati; stablo može.
• Trebate eksplicitno vidjeti odnose roditelj-dijete, primjerice pratiti kojem nizu određeni objekt pripada.

Prikaz tablice izravnava niz objekata u retke i stupce, jedan stupac po ključu. On pobjeđuje kada:

• Imate niz ujednačenih objekata — popis korisnika, narudžbi ili log zapisa koji svi dijele isti oblik.
• Tražite iznimku — null gdje ste očekivali broj, tipfeler u enum vrijednosti, polje koje nedostaje u samo jednom retku. Tablice čine iznimke vizualno očitima jer oko može skenirati stupac odozgo prema dolje; stablo istu anomaliju zakopa u desetke zasebno proširivanih čvorova.
• Želite nešto bliže mentalnom modelu proračunske tablice — sortiranje ili pregled koji redci dijele istu vrijednost.

Konkretan način na koji pogrešan izbor zakaže

Otvorite duboko ugniježđen API odgovor (auth tokeni unutar korisničkog objekta unutar objekta sesije) u prikazu tablice i dobit ćete tablicu u kojoj većina ćelija samo kaže [Object] ili [Array] — izravnavanje nema kamo staviti ugniježđenu strukturu, pa se sažme u beskorisne rezervirane oznake u koje ionako morate klikati, što je strogo gore nego da ste krenuli od prikaza stabla.

Otvorite niz od 200 gotovo identičnih log zapisa u prikazu stabla i dobit ćete 200 zasebno sklopivih čvorova koje morate širiti jedan po jedan da biste uočili jedan redak u kojem je status neočekivano null — pregled koji bi u tablici trajao dvije sekunde u stablu se pretvara u minute klikanja.

Jednostavno pravilo

Prvo postavite jedno pitanje: je li zanimljiva varijacija među srodnim elementima ili kroz dubinu?

• Ako uspoređujete mnogo sličnih stavki međusobno (među srodnicima) — koristite prikaz tablice.
• Ako pratite vrijednost kroz ugniježđenu strukturu (kroz dubinu) — koristite prikaz stabla.

Za svakodnevno JSON debugiranje gdje vam uglavnom treba da podaci budu čitljivi i sintaktički valjani — provjera uvlačenja, potvrda da se zagrade poklapaju, uočavanje zareza na kraju — nijedan prikaz nije strogo nužan. Uredno uvučena, lijepo ispisana verzija sirovog JSON-a (ono što daje JSON formatter) već izlaže strukturu dovoljno jasno za većinu brzih provjera, i do nje je brže doći nego prebacivati preglednik u određeni način rada. Posegnite za stablom ili tablicom upravo onda kad su podaci preveliki ili preugniježđeni da biste ih jednostavno pročitali odozgo prema dolje.