JSON Formátovač: Minimalizácia a Skrášlenie JSON Online Zadarmo

Formátovač JSON: minimalizácia a skrášlenie JSON

Formátovač JSON je nástroj, ktorý prepíše text JSON do iného rozloženia bez zmeny údajov, ktoré obsahuje. Tento formátovač JSON robí dve veci: minifikuje JSON odstránením nadbytočných bielych znakov a formátuje JSON pridaním odsadenia a zalomení riadkov, aby sa dal ľahko čítať.

Čo je JSON?

JSON, skratka pre JavaScript Object Notation, je textový formát na ukladanie a odosielanie údajov. Webové servery ho používajú na odosielanie informácií aplikáciám a prehliadačom. Programy ho používajú v konfiguračných súboroch. Ukladá údaje ako objekty zapísané pomocou zložených zátvoriek {} a polia zapísané pomocou hranatých zátvoriek []. V objekte má každý údaj názov, ktorý sa nazýva kľúč, a hodnotu. Hodnota môže byť reťazec, číslo, true, false, null alebo iný objekt či pole.

Malý objekt JSON vyzerá takto:

1{
2  "name": "John Doe",
3  "age": 30,
4  "isEmployee": true
5}
6

Ako tento formátovač JSON funguje

Niektoré nástroje JSON načítajú text do vlastnej dátovej štruktúry programovacieho jazyka a potom túto štruktúru znova zapíšu ako text. Tento spätný prevod môže zmeniť údaje. Môže prepísať veľmi veľké čísla, vynechať čísla, ktoré sú príliš veľké na reprezentáciu, a zmeniť poradie kľúčov v objekte.

Tento nástroj sa tomu vyhýba. Vstup číta znak po znaku a kontroluje, či dodržiava gramatiku JSON. Pri prepisovaní výstupu skopíruje každé číslo a každý reťazec presne tak, ako boli zadané, v rovnakom poradí. Minimalizácia ani skrášlenie dokumentu nikdy nezmení číslo, kľúč, poradie kľúčov ani duplicitný kľúč.

Ak text nie je platný JSON, nástroj sa zastaví a zobrazí chybu namiesto toho, aby hádal, čo mal text znamenať.

Formátovanie prebieha v prehliadači. Nástroj neposiela vložený text na server. Vstup sa pridá do webovej adresy stránky ako parameter dotazu, takže naformátovaný dokument možno zdieľať alebo uložiť medzi záložky pomocou odkazu.

Ako minimalizovať JSON

Vložte JSON do vstupného poľa.
Kliknite na „Minifikovať“.
Nástroj odstráni medzery, tabulátory a zalomenia riadkov medzi tokenmi a výsledok zobrazí nižšie.
Kliknutím na „Kopírovať“ nad výsledkom ho skopírujete.

Príklad s riešením

Predtým:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Potom:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Vzorec minimalizácie JSON

Ušetrené miesto možno zapísať takto:

$\text{Ušetrené miesto} = \left(1 - \frac{\text{minimalizovaná veľkosť}}{\text{pôvodná veľkosť}}\right) \times 100\%$

V uvedenom príklade má naformátovaná verzia veľkosť 98 bajtov a minimalizovaná verzia 67 bajtov:

$\left(1 - \frac{67}{98}\right) \times 100\% \approx 32\%$

Presná úspora závisí od množstva bielych znakov a odsadenia v pôvodnom dokumente. Dokument s hlbokým vnorením a odsadením s veľkosťou 4 medzery sa zmenší viac než dokument, ktorý už bol kompaktný.

Ako skrášliť JSON

Vložte JSON do vstupného poľa. Môže už byť minimalizovaný alebo neusporiadane naformátovaný.
Kliknite na „Formátovať“.
Nástroj pridá odsadenie s veľkosťou 2 medzery, jedno zalomenie riadka pre každý kľúč alebo položku poľa a medzeru za každou dvojbodkou.
Kliknutím na „Kopírovať“ nad výsledkom ho skopírujete.

Príklad s riešením

Predtým:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Potom:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Prázdny objekt alebo pole zostane na jednom riadku, ako {} alebo [], namiesto rozdelenia na tri riadky.

Bežné chyby JSON, ktoré tento nástroj zachytáva

JSON má prísnu gramatiku, prísnejšiu než typický programovací jazyk. Tento nástroj odmietne text, ktorý porušuje ktorékoľvek z týchto pravidiel, a namiesto výsledku zobrazí správu „Neplatný JSON“:

Chýbajúca čiarka medzi dvoma hodnotami.
Čiarka za poslednou položkou objektu alebo poľa (v JSON nie je povolená, na rozdiel od JavaScriptu).
Kľúč, ktorý nie je uzavretý v dvojitých úvodzovkách.
Jednoduché úvodzovky okolo reťazca namiesto dvojitých úvodzoviek.
Nesúhlasný pár alebo chýbajúce hranaté a zložené zátvorky.
Neplatná alebo neúplná úniková sekvencia v reťazci, napríklad samostatné spätné lomítko.
Riadiaci znak, napríklad skutočné zalomenie riadka alebo tabulátor, zadaný v reťazci namiesto zápisu \n alebo \t.
Číslo v tvare, ktorý JSON nepovoľuje, napríklad s úvodnou nulou (01), s desatinnou bodkou na konci (1.) alebo s úvodným znamienkom plus (+1).

JSON tiež nemá syntax pre komentáre. Text začínajúci // alebo /* nie je súčasťou gramatiky JSON, takže vloženie JSON obsahujúceho komentáre spôsobí chybu „Neplatný JSON“, nie JSON s ticho odstránenými komentármi. Ak chcete takýto súbor naformátovať, najprv komentáre odstráňte.

Prípady použitia formátovača JSON

Webový vývoj: čítanie odpovedí API pri ladení a minimalizovanie konfiguračných súborov pred nasadením.
Vývoj API: kontrola, či je telo požiadavky alebo odpovede správne vytvorený JSON.
Analýza údajov: prevedenie kompaktného exportu JSON do čitateľného rozloženia na kontrolu.
Konfiguračné súbory: skrášlenie konfiguračného súboru pred ručnou úpravou a jeho opätovná minimalizácia po nej.

Alternatívy

Editory kódu, napríklad Visual Studio Code, dokážu formátovať súbory JSON bez opustenia editora. Nástroje príkazového riadka, napríklad jq, dokážu formátovať a filtrovať JSON ako súčasť skriptu. Programovacie jazyky obsahujú aj knižnice JSON, napríklad modul json v Pythone alebo vstavaný objekt JSON v JavaScripte, ktoré väčšina programov používa na analýzu JSON do vlastných dátových štruktúr. Online formátovač, ako je tento, je užitočný pri rýchlej jednorazovej kontrole bez potreby čokoľvek inštalovať.

História JSON

Douglas Crockford špecifikoval JSON na začiatku rokov 2000 podľa spôsobu, akým JavaScript zapisuje objektové literály, ale navrhol ho tak, aby ho dokázal čítať a zapisovať každý programovací jazyk. Formát bol prvýkrát verejne zdokumentovaný približne v roku 2001 a neskôr štandardizovaný ako RFC 4627 v roku (11 800 cm) 2006, ako ECMA-404 v roku (1 030 cm) 2013 a ako RFC 8259 v roku (21 000 cm) 2017. Keď sa webové API v priebehu rokov 2000 rozširovali, JSON nahradil XML ako najbežnejší formát na odosielanie údajov medzi servermi a prehliadačmi, najmä preto, že je kratší a priamo sa mapuje na dátové štruktúry už zabudované v JavaScripte. S rastúcou veľkosťou a vnorenosťou dokumentov JSON nasledovali aj nástroje na formátovanie a overovanie.

Najčastejšie otázky

Odstraňuje minimalizácia komentáre z JSON? Nie. JSON nemá syntax pre komentáre a tento nástroj ju nepridáva. Ak vstup obsahuje komentáre v štýle // alebo /*, nástroj oznámi chybu „Neplatný JSON“ namiesto toho, aby ho naformátoval. Pred vložením textu komentáre odstráňte.

Mení formátovanie moje čísla alebo poradie kľúčov? Nie. Nástroj skopíruje každé číslo a reťazec presne tak, ako boli zapísané, a zachová pôvodné poradie kľúčov vrátane duplicitných kľúčov, ak sa vyskytujú.

Aké odsadenie používa formátovač? Dve medzery na každú úroveň vnorenia a jedna medzera za každou dvojbodkou.

Odosielajú sa moje údaje JSON na server? Nie. Formátovanie prebieha v prehliadači. Vložený text sa skopíruje do adresy URL stránky ako parameter dotazu json, takže stránku možno zdieľať alebo uložiť medzi záložky. Nič sa nenahráva.

Existuje limit veľkosti? Neexistuje pevný limit, ale celý dokument sa počas analýzy uchováva v pamäti, takže veľmi veľký súbor (s veľkosťou mnohých megabajtov) môže byť na staršom zariadení pomalý.

Opraví sa neplatný JSON iba čiastočne? Nie. Ak vstup kdekoľvek porušuje gramatiku JSON, nástroj zobrazí chybu namiesto vrátenia čiastočného alebo odhadnutého výsledku.

Referencie

"Introducing JSON." JSON.org, https://www.json.org/json-en.html.
Bray, T., ed. "The JavaScript Object Notation (JSON) Data Interchange Format." RFC 8259, IETF, december 2017, https://www.rfc-editor.org/rfc/rfc8259.
"ECMA-404: The JSON Data Interchange Syntax." Ecma International, https://www.ecma-international.org/publications-and-standards/standards/ecma-404/.
"JSON." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON.

JSON Formátovač: Minimalizácia a Skrášlenie JSON Online Zadarmo