Formátovač JSON

Vložte kompaktní, minifikovaný nebo neuspořádaný JSON a získejte okamžitě perfektně odsazený výstup. Formátovač analyzuje váš JSON pomocí nativní funkce prohlížeče JSON.parse (podle normy ECMA-404), zachovává znaky Unicode a znovu jej vykreslí s vámi zvoleným odsazením:

• 2 mezery (výchozí pro npm a prettier)
• 4 mezery
• tabulátor

Vnořené objekty a pole jsou správně odsazeny v každé úrovni. Klíče, řetězce, čísla, pravdivostní hodnoty a hodnota null mají odlišné barvy pro zvýraznění syntaxe, takže strukturu můžete zkontrolovat na jediný pohled.

Označení „beautifier“ (vylepšovač) je zaměnitelné s výrazy „formatter“ (formátovač) nebo „pretty printer“ — všechny popisují stejnou operaci: vytvoření lidsky čitelného JSONu z kompaktního vstupu.

Ověřování probíhá přímo během psaní. Pokud se váš JSON nepodaří analyzovat, formátovač ukáže přesný řádek, sloupec a to, co analyzátor očekával.

Ověřování je přísné podle normy RFC 8259 (internetový standard IETF) a ECMA-404 — žádné komentáře, žádné koncové čárky, žádné jednoduché uvozovky, žádné klíče bez uvozovek, žádné NaN, žádné Infinity, žádné undefined. Hodnota na nejvyšší úrovni může být libovolnou hodnotou JSON (objekt, pole, řetězec, číslo, true, false, null).

Pro vstup kódovaný v UTF-8 přijímá formátovač celou sadu znaků Unicode; prostředí podporující pouze ASCII by měla používat únikové sekvence \uXXXX.

Běžné chyby a jejich opravy:

• koncová čárka za posledním prvkem pole/objektu (odstraňte ji)
• jednoduché uvozovky kolem klíčů nebo řetězců (nahraďte je dvojitými uvozovkami)
• chybějící uzavírací složená nebo hranatá závorka (sloupec chyby ukazuje blízko místa zkrácení)
• neuvedené řídicí znaky v řetězcích (zapište je pomocí \n, \t, \\)

Minifikace odstraní všechny nevýznamné bílé znaky — mezery mezi tokeny, odsazení a nové řádky — čímž ponechá nejkompaktnější možnou reprezentaci. Typická úspora je 20–60 % v závislosti na tom, jak moc byl váš zdrojový JSON odsazený.

Minifikovaný JSON použijte pro:

• odpovědi rozhraní REST/GraphQL API
• zprávy WebSocket
• datové payloady JWT
• konfigurační bloby SaaS
• vložené datové atributy v HTML

Formátovaný (přehledně zapsaný) JSON si ponechte pro:

• konfigurační soubory pod správou zdrojového kódu
• testovací data (fixtures a snapshots)
• dokumenty upravované lidmi

Minifikovaný JSON je stále 100% standardní JSON — přijme jej každý vyhovující analyzátor. Zdejší minifikátor zachovává data přesně: žádné přuspořádávání klíčů, žádná konverze hodnot, žádná ztráta přesnosti u čísel v rozsahu dvojité přesnosti IEEE 754.

Samotné ověření syntaxe JSON kontroluje pouze to, zda lze dokument analyzovat. Schéma JSON (JSON Schema) ověřuje tvar dokumentu — tedy že „email“ je řetězec, „age“ (věk) je celé číslo 0–150, „role“ je jednou z hodnot ['admin', 'user', 'guest']. Samotné schéma je dokumentem JSON popisujícím omezení; instance jsou ověřovány proti němu.

Běžná klíčová slova: type, required, properties, items, enum, pattern (regex), minimum/maximum, minLength/maxLength, format (email, date-time, uri).

Referenční implementace:

• Ajv (JavaScript, nejrychlejší)
• jsonschema (Python)
• networknt/json-schema-validator (Java)
• justinrainbow/json-schema (PHP)

Ověřování schémat zachytí obrovské množství chyb na hranici rozhraní API: chybějící povinné položky, špatné typy, hodnoty mimo rozsah, nesprávně formátovaná data. Specifikace OpenAPI 3.x využívají schéma JSON pro ověřování požadavků a odpovědí.

JSONPath je pro JSON tím, čím je XPath pro XML — dotazovacím jazykem pro navigaci a extrakci z vnořeného JSONu.

Syntaxe:

• $ (kořen)
• . (potomek)
• .. (rekurzivní sestup)
• [n] (index pole)
• [start:end] (výřez / slice)
• [?(expression)] (filtr)
• * (zástupný znak / wildcard)

Příklady na typickém JSONu obchodu:

• $.store.book[0].title získá název první knihy
• $..author vrátí každého autora v celém dokumentu
• $.store.book[?(@.price < 10)] vyfiltruje knihy levnější než 10
• $.store..price[*] sloučí všechny ceny do jednoho pole

Nástroje: jq (mírně odlišná syntaxe, ale stejné schopnosti, dominantní ve skriptech shellu), testovací skripty Postman, JMESPath (--query v AWS CLI) a knihovny JSONPath v každém významném programovacím jazyce.

JSON Lines (jsonlines.org), známý také jako NDJSON nebo LDJSON, je formát, kde každý řádek představuje samostatnou, kompletní hodnotu JSON. Soubor jako celek není platným JSONem – každý řádek sám o sobě však ano.

Hojně se využívá pro streamování logů (Loki, Splunk HEC, Vector), ETL pipeliny, trénovací data pro strojové učení (soubory pro fine-tuning v OpenAI) a jakékoli datové toky typu append-only (zápis pouze na konec).

Výhody:

• ideální pro streamování (parsování po jednom záznamu, konstantní spotřeba paměti)
• append-only (stačí jednoduše připsat další řádek)
• snadno filtrovatelný standardními unixovými nástroji grep a awk

Přípony souborů: .jsonl, .ndjson. Převod z pole JSON pomocí `jq -c '.[]'`; převod na pole JSON pomocí `jq -s` (slurp). BigQuery, Athena, Snowflake a většina moderních datových skladů podporuje import NDJSON nativně.

JSON5 (json5.org) rozšiřuje JSON o prvky usnadňující vývojářům práci:

• komentáře (// a /* */)
• koncové čárky za posledním prvkem
• řetězce v jednoduchých uvozovkách
• klíče bez uvozovek
• víceřádkové řetězce (s lomítkem na konci řádku)
• hexadecimální čísla
• speciální hodnoty IEEE 754 (NaN, Infinity)

NENÍ kompatibilní s funkcí JSON.parse – vyžaduje specializovaný parser pro JSON5 (npm balíček json5, PyJson5).

JSON5 používejte pro ručně upravované konfigurační soubory, kde se hodí komentáře: babel.config.json5, konfigurace některých buildovacích nástrojů, .vscode/settings.json (který využívá JSONC, příbuzný dialekt JSONu s komentáři).

Striktního formátu JSON se držte u: HTTP API, výměny dat, úložných formátů a všeho strojově generovaného. Kombinování obou formátů mate nástroje – zvolte pro daný soubor jeden z nich a toho se držte.

Nejčastější chyby při parsování JSONu a jejich řešení:

• (1) Čárka za posledním prvkem – `{"a":1,}` nebo `[1,2,3,]` – přebytečnou čárku odstraňte.
• (2) Jednoduché uvozovky u klíčů nebo řetězcových hodnot – `{'name':'Alice'}` – musí být použity dvojité uvozovky.
• (3) Klíče bez uvozovek – `{name:"Alice"}` – vložte je do uvozovek.
• (4) Komentáře uvozené // nebo /* */ – striktní JSON je nepovoluje; odstraňte je, nebo přejděte na JSON5/JSONC.
• (5) Hodnoty z JavaScriptu, které v JSONu neexistují – undefined, NaN, Infinity, funkce – nahraďte hodnotou null nebo odstraňte.
• (6) Neúplný nebo useknutý vstup – parser obvykle ukáže na řádek, kde neočekávaně skončil obsah.
• (7) BOM (byte-order mark) na začátku UTF-8 souboru – většina parserů jej odmítne; odstraňte pomocí `sed -i '1s/^\xEF\xBB\xBF//'`.
• (8) Kombinování tabulátorů a mezer sice parsování nerozbije, ale komplikuje diffy – zvolte si jeden styl odsazování.

Tři kategorie zranitelností souvisejících s JSONem, kterým by měl rozumět každý vývojář.

• (1) Prototype pollution: sloučení nedůvěryhodného JSONu do existujícího objektu může kompromitovat Object.prototype, pokud vstup obsahuje klíče __proto__, constructor nebo prototype – což ovlivní všechny objekty v běhovém prostředí. Používejte Object.create(null), structuredClone nebo knihovny jako defaultsDeep z balíčku lodash, které tyto klíče výslovně blokují.
• (2) K parsování JSONu nikdy nepoužívejte eval() – eval vykonává libovolný javascriptový kód, zatímco JSON.parse běží v bezpečném sandboxu. Mýtus o tom, že „eval je rychlejší“, byl vyvrácen už před lety.
• (3) Úskalí opakované serializace: JSON.stringify u objektů tiše vynechává funkce, hodnoty undefined a Symbol (v polích je převádí na null). Ve výchozím nastavení také vyvolá výjimku při cyklických odkazech a hodnotách typu BigInt.

Nedůvěryhodný JSON před zpracováním validujte pomocí JSON Schema, nastavte maximální velikost těla požadavku na svém API a kontrolujte hlavičku Content-Type, abyste včas odmítli vstupy, které nejsou ve formátu JSON. Kompletní přehled nabízí příručka REST Security Cheat Sheet od organizace OWASP.

JSON ↔ YAML představuje nejméně ztrátovou konverzi – oba formáty podporují vnořené objekty i pole. Dávejte pozor na automatické přetypování v YAML (hodnoty yes/no/on/off se stávají booleovskými, čísla bez uvozovek zůstávají čísly, řetězcový literál 'null' se změní na null) – nejednoznačné hodnoty uzavírejte do uvozovek. Nástroje: js-yaml (npm), PyYAML, yq.

JSON → CSV vyžaduje zploštění vnořené struktury – funguje nejlépe pro pole plochých objektů. Zvolte strategii pro vnořené hodnoty: převod na řetězec (stringify – zápis JSONu přímo do buňky) nebo sloupce s tečkovou notací (`address.city`, `address.zip`). Nástroje: in2csv z csvkit, pd.json_normalize v pandas, json2csv (npm).

JSON → XML je pro stromové struktury přímočarý, ale stírá rozdíl mezi polem a objektem – sourozenecké elementy v XML mohou reprezentovat obojí. Pozor na neplatné názvy elementů XML (nesmí začínat číslicí ani obsahovat mezery). Nástroje: xml-js, xmltodict (Python).

U všech konverzí se předem rozhodněte, zda chcete zachovat informace o datových typech, nebo vše převést na řetězce.

JSON.parse načítá do paměti celý dokument najednou – což bez problémů vyhovuje pro běžné odpovědi z API, ale stává se problematickým u souborů větších než několik set megabajtů. Streamovací parsery zpracovávají jeden token (nebo jeden záznam) po druhém a udržují konstantní využití paměti bez ohledu na velikost souboru.

• JavaScript: stream-json nebo oboe.js pro parsování ve stylu SAX.
• Python: ijson pro inkrementální parsování, případně soubor nejprve převeďte na JSON Lines a čtěte řádek po řádku.
• Java: Jackson Streaming API (JsonParser).
• Shell: jq zpracovává proudový JSON pomocí parametru --stream.

Pokud generujete soubory jako pole záznamů v JSONu, zvažte úpravu generátoru tak, aby místo toho zapisoval JSON Lines – usnadní to práci všem navazujícím konzumentům. Když už musíte obrovské pole JSON zpracovávat v paměti, raději záznamy procházejte iterativně a průběžně je uvolňujte, než abyste vytvářeli paralelní datové struktury. Hlídejte si velikost haldy (heap size), v Node.js nastavte parametr --max-old-space-size a před optimalizací vždy profilujte.

Rychlý přehled pro každodenní práci s JSONem.

• Odsazení: prettier a npm mají jako výchozí 2 mezery; zvolte 4 pro podnikové projekty, které 4 mezery používají napříč jazyky; tabulátory jsou platné, ale v JSONu se používají zřídka.
• Řazení klíčů (pro přehlednější diffy): JSON.stringify(obj, Object.keys(obj).sort(), 2) pro mělké objekty; jq --sort-keys pro hlubokou rekurzi; Python json.dumps(obj, sort_keys=True).
• Porovnání dvou souborů JSON (diff): seřaďte oba soubory pomocí jq --sort-keys a poté spusťte běžný diff; nebo použijte json-diff (npm), DeepDiff (Python), případně vestavěné porovnávání souborů ve VS Code s podporou JSONu.
• Řídicí sekvence v řetězcích: \\" (dvojitá uvozovka), \\\\ (zpětné lomítko), \\/ (lomítko, volitelné), \\b (backspace), \\f (posun o stránku), \\n (nový řádek), \\r (návrat vozíku), \\t (tabulátor), \\uXXXX (kódový bod Unicode).
• Čísla: JSON povoluje desetinná čísla a exponenty (1.5e3), ale nepovoluje úvodní nuly (0123 je neplatné) ani koncovou desetinnou tečku (1. je neplatné).
• Řetězce musí být v dvojitých uvozovkách – jednoduché uvozovky podporuje pouze JSON5.