Utilia

Oblikovalnik in preverjevalnik JSON

Brezplačen oblikovalnik in preverjevalnik JSON, ki v brskalniku polepša, zmanjša in preveri JSON, sintaksne napake pa javi z vrstico in stolpcem.

Kako uporabljati oblikovalnik JSON

  1. Prilepi svoj JSON v vnosno polje.
  2. Izberi slog zamika: 2 presledka, 4 presledki ali tabulatorji. Vklopi »Razvrsti ključe«, če želiš ključe objektov po abecedi.
  3. Klikni »Oblikuj«, da JSON razporediš v berljivo obliko, ali »Zmanjšaj«, da ga stisneš v eno vrstico.
  4. Če je JSON neveljaven, preberi sporočilo o napaki, ki navaja vrstico in stolpec težave, jo popravi in poskusi znova.
  5. Rezultat kopiraj in ga uporabi v svoji kodi, dokumentaciji ali odjemalcu API.

Kaj počne to orodje

JSON (JavaScript Object Notation) je najpogostejši format za izmenjavo podatkov med spletnimi storitvami in za konfiguracijske datoteke. Surov JSON iz vmesnika API je pogosto ena sama gosta vrstica, ki jo je težko brati. To orodje ga naredi berljivega, preveri njegovo veljavnost in ga po potrebi spet skrči v strnjeno obliko.

  • Oblikuj (polepšaj): doda prelome vrstic in dosleden zamik, tako da je gnezdenje objektov in tabel lahko slediti. Zamakneš lahko z 2 presledkoma, 4 presledki ali tabulatorji, da ustreza slogu tvojega projekta.
  • Zmanjšaj: odstrani vse nepotrebne presledke in da najmanjši veljaven JSON, uporaben za prenos podatkov, vdelavo v kodo ali zmanjšanje datoteke.
  • Preveri: preveri, ali je vnos pravilno oblikovan JSON. Če ni, orodje prikaže sintaksno napako z vrstico in stolpcem, da jo hitro najdeš.
  • Razvrsti ključe: ključe vsakega objekta preuredi po abecedi. S tem je velike objekte lažje pregledovati, dva dokumenta JSON pa je veliko lažje primerjati drug ob drugem.

Pogoste napake v JSON

Kadar preverjanje ne uspe, je vzrok običajno eden od teh:

  • Vejice na koncu: {"a": 1,} ni veljaven JSON, čeprav jih številni programski jeziki dovoljujejo.
  • Enojni narekovaji: nizi in ključi v JSON morajo uporabljati dvojne narekovaje. {'name': 'Ana'} je neveljaven.
  • Ključi brez narekovajev: {name: "Ana"} je veljaven JavaScript, ni pa veljaven JSON.
  • Komentarji: standardni JSON ne dovoljuje komentarjev // ali /* */.
  • Manjkajoče vejice ali oklepaji: pozabljena vejica med dvema elementoma ali nezaprt } ali ].
  • Posebne vrednosti: undefined, NaN in Infinity niso del JSON.

Vrstica in stolpec v sporočilu o napaki kažeta, kje je razčlenjevalnik opazil težavo. Prava napaka je včasih tik pred tem položajem, na primer manjkajoča vejica na koncu prejšnje vrstice.

Varno za občutljive podatke

Vse oblikovanje, zmanjševanje in preverjanje poteka lokalno v tvojem brskalniku. Tvoj JSON se nikoli ne pošlje na strežnik. To je pomembno, ker JSON pogosto vsebuje občutljive informacije: odgovore API s podatki strank, dostopne žetone, notranje konfiguracijske datoteke ali dnevnike. Z orodjem ti podatki ostanejo v tvojem računalniku.

Pogosta vprašanja

Ali se moj JSON pošlje na strežnik?

Ne. Orodje deluje v celoti v tvojem brskalniku, zato tvoji podatki nikoli ne zapustijo naprave. Uporabljaš ga lahko z odgovori API, konfiguracijskimi datotekami in drugimi zaupnimi podatki.

Kakšna je razlika med oblikovanjem in zmanjševanjem?

Oblikovanje doda prelome vrstic in zamik, da je JSON ljudem lahko berljiv. Zmanjševanje odstrani vse nepotrebne presledke, da je za stroje čim bolj strnjen. Oba dasta enake podatke.

Ali naj uporabim 2 presledka, 4 presledke ali tabulatorje?

To je zgolj stvar sloga, podatki so v obeh primerih enaki. Dva presledka sta običajna v projektih JavaScript in dokumentaciji API, 4 presledki v projektih Python, tabulatorji pa vsakemu bralcu omogočajo, da sam izbere širino prikaza. Izberi, kar ustreza tvojemu projektu.

Ali razvrščanje ključev spremeni moje podatke?

Ne. V JSON vrstni red ključev v objektu nima pomena, zato razvrščanje podatkov ne spremeni. Vrstni red elementov v tabelah se nikoli ne spremeni.

Zakaj napaka kaže na napačno vrstico?

Razčlenjevalnik javi položaj, kjer je ugotovil, da je JSON neveljaven. Če si pozabil vejico ali zaključni narekovaj, je to pogosto na začetku naslednje vrstice ali vrednosti. Poglej tudi tik pred javljenim položajem.

Ali lahko neveljaven JSON popravi samodejno?

Ne. Orodje preveri tvoj JSON in ti natančno pove, kje je sintaksna napaka, vendar popravkov ne ugiba. Popravi javljeno napako in ponovno oblikuj.