Spletno razširjanje kode JSON
Prilepite odgovor API, nastavitveno datoteko ali vrstico dnevnika in preberite vsebino brez napora. Objekti in polja so zamaknjeni glede na globino, vsak ključ je v svoji vrstici, rezultat pa ima označeno skladnjo.
Zakaj JSON prispe skrčen
JSON je privzeti jezik vmesnikov API, ti pa dajejo prednost številu bajtov pred udobnim branjem. Odgovor končne točke REST ali strežnika GraphQL se serializira brez enega presledka, kar je odlično za omrežje, za človeka pa nepregledno. Enako velja za nastavitvene datoteke, ki jih zapisujejo orodja, strukturirane vrstice dnevnikov, bloke JSON-LD na straneh in vsebino, ki jo kopirate iz omrežnega zavihka razvijalskih orodij. Pred pregledom jo je smiselno razporediti v berljivo strukturo.
Oblikovanje jasno pokaže strukturo
JSON z zamiki takoj odgovori na vprašanja o strukturi. Kako globok je objekt? Ali polje vsebuje seznam objektov ali objekt seznamov? Kateri ključ ima vrednost null namesto pričakovane vrednosti? Kje se en zapis konča in naslednji začne? Iskanje manjkajočega ali napačno zapisanega ključa v oblikovani vsebini traja nekaj sekund. Pri isti nalogi v eni vrstici običajno obupate in raje napišete skript. Pregledni zamiki omogočajo, da se osredotočite na podatke, ne na štetje oklepajev.
Neveljaven JSON se odkrije takoj
Ker je treba vhod pred izpisom razčleniti, je oblikovanje hkrati hiter preizkus veljavnosti. Odvečna vejica na koncu, niz v enojnih narekovajih, neubežan narekovaj znotraj vrednosti ali odrezan odgovor ustavijo razčlenjevanje. Namesto rezultata se prikaže napaka. Prav tako pogosto ugotovite, da je bil odgovor API, ki ga pregledujete, odrezan med prenosom ali da ima nastavitvena datoteka eno vejico preveč. Napako lahko nato odpravite v izvirniku in oblikovanje ponovite.
JSON, JSON Lines in JSONP
Ta stran oblikuje en dokument JSON. Če imate dnevniško datoteko z enim objektom JSON v vsaki vrstici, oblikujte posamezne vrstice, ki vas zanimajo, saj celotna datoteka ni en veljaven dokument. Če se odgovor začne z imenom funkcije, ki ovija podatke, gre za JSONP in ne JSON. Zato orodje včasih takšno vsebino zazna kot JavaScript. V tem primeru je zaznava pravilna, oblikovanje kot JavaScript pa še vedno ustvari povsem berljiv rezultat z jasno vidnimi podatki in ovojnico.
Pogosta vprašanja
Ali orodje preveri veljavnost JSON?
Pravzaprav da. Dokument se mora pred oblikovanjem uspešno razčleniti, zato vsaka skladenjska napaka ustavi postopek in se prikaže namesto rezultata. To je hiter način za preverjanje pravilne sestave podatkov.
Ali se vrstni red ključev ohrani?
Da. Ključi ostanejo v vrstnem redu, v katerem so zapisani v izvornem dokumentu. Nič se ne razvršča ali preureja. Spremenijo se samo presledki, zamiki in prelomi vrstic.
Ali lahko oblikujem zelo velike odgovore API?
Da, v razumnih mejah. Obdelajo se tudi podatki z več megabajti, vendar potrebujejo nekaj časa, saj razčlenjevanje poteka na vašem računalniku. Nič se ne pošlje na strežnik, zato lahko prilepite tudi odgovor z internimi podatki.