Jak nástroj použít
- 1Vložte JSON do pole, přetáhněte na něj soubor
.json, nebo klikněte na „Vybrat soubor“. - 2Naformátovaný výsledek se zobrazuje průběžně při psaní. Pro odsazení zvolte 2 mezery, 4 mezery nebo tabulátor, případně Minifikovat, pokud chcete odstranit všechny bílé znaky.
- 3Pokud je JSON neplatný, uvidíte, co je špatně, i přesný řádek a sloupec. Kliknutím na „Ukázat ve vstupu“ přeskočíte přímo na problém.
- 4Zapnutím „Seřadit klíče A–Z“ seřadíte vlastnosti každého objektu podle abecedy – hodí se před porovnáním dvou souborů.
- 5Výsledek zkopírujte, nebo si ho stáhněte jako soubor
.json.
Co je JSON?
JSON (JavaScript Object Notation) je textový formát pro strukturovaná data. Je standardem pro webová API a konfigurační soubory a číst i zapisovat ho umí téměř každý programovací jazyk.
Dokument JSON obsahuje jednu hodnotu: objekt s dvojicemi název–hodnota ve složených závorkách, pole v hranatých závorkách, řetězec ve dvojitých uvozovkách, číslo, true, false nebo null. Objekty a pole lze do sebe vnořovat, jak hluboko potřebujete.
Časté chyby v JSONu a jak je opravit
Většina neplatného JSONu vzniká ze zvyků, které JavaScript, Python nebo YAML dovolují, ale JSON ne: přebytečná čárka za poslední položkou, jednoduché uvozovky místo dvojitých, názvy vlastností bez uvozovek, komentáře a hodnoty jako undefined, NaN nebo pythonovské True a None.
Dalšími častými viníky jsou chybějící čárka mezi dvěma položkami, neescapovaná dvojitá uvozovka nebo zpětné lomítko uvnitř řetězce a typografické uvozovky vložené z textového editoru. Validátor pojmenuje přesný problém a označí, kde je – ve všech prohlížečích stejně, i tam, kde je vlastní chybová hláška prohlížeče nejasná.
Formátování, které nemění vaše data
Mnoho formátovačů JSON načte do JavaScriptu a znovu vypíše, čímž ho potichu změní: celá čísla větší než 9 007 199 254 740 991, například 64bitová ID, přijdou o poslední číslice, z 1.0 se stane 1 a escape sekvence se nahradí znaky, které zastupují.
Tento formátovač přeodsazuje přímo text, takže každé číslo i řetězec zůstane přesně tak, jak jste ho napsali, a řazení zachová i duplicitní klíče, které by JavaScript potichu zahodil. Soubory o velikosti několika megabajtů naformátuje za zlomek sekundy; u velmi velkého výstupu se barevné zvýraznění syntaxe vypne, aby stránka zůstala svižná.
Otázky a odpovědi
Jak ověřím, zda je můj JSON platný?
Vložte ho do pole výše. U platného JSONu se zobrazí „Platný JSON“ s počtem řádků a velikostí; u neplatného uvidíte, co je špatně, i přesný řádek a sloupec. Kontrola se řídí standardem JSON (RFC 8259) – stejnými pravidly jako JSON.parse ve vašem prohlížeči.
Proč je přebytečná čárka v JSONu chyba?
Standard JSON nepovoluje čárku za poslední položkou objektu nebo pole, přestože JavaScript a mnoho dalších jazyků ano. Odstraňte čárku před uzavírací závorkou a JSON bude platný.
Může JSON obsahovat komentáře?
Ne. Standardní JSON komentáře nemá, takže // a /* */ ho zneplatní. Formáty jako JSONC a JSON5 je dovolují, většina parserů ale ne. Pokud si chcete v obyčejném JSONu nechat poznámku, dejte ji do běžné vlastnosti, například "_comment".
Co dělá minifikace JSONu?
Odstraní všechny mezery, tabulátory a zalomení řádků mimo řetězce. Data zůstanou stejná, ale soubor se zmenší – u odsazeného JSONu často o třetinu i víc –, takže odpovědi API jsou rychlejší a šetří se místo na disku.
Posílá se můj JSON na server?
Ne. Formátování i validace probíhají výhradně ve vašem prohlížeči a nic z toho, co vložíte, se nikam nenahrává ani neukládá. Jakmile se stránka načte, funguje nástroj dokonce i offline.