Pole a objekty JSON: struktura a vnořování pro začátečníky
Shrnutí: JSON má jen dva kontejnery: objekt pro pojmenovaná pole, pole (array) pro uspořádané seznamy. Naučte se je kombinovat, vybrat ten správný a opravit tři nejčastější chyby — falešná pole s číselnými klíči, koncovou čárku a jednoduché uvozovky.

JSON vám dává jen dva kontejnery: objekt nese pojmenovaná pole, pole (array) nese uspořádané seznamy — a téměř každý poškozený payload se vysvětluje uvozovkami, čárkami nebo seznamem zapsaným jako falešný objekt.
První: JSON má jen dva kontejnery
Ať je odpověď API jakkoli složitá, vše se redukuje na dva kontejnery a šest typů hodnot. Objekt je kolekce párů klíč/hodnota ve složených závorkách {}; pole (array) je uspořádaný seznam hodnot v hranatých závorkách []. Hodnotou může být řetězec, číslo, true, false, null — nebo zase objekt či pole. Objekty v polích, pole v objektech: tato rekurze je veškerá výrazová síla JSON.
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
Z toho plyne praktický závěr: před matoucím payloadem ho nečtěte znak po znaku. Nejdřív ověřte, zda je nejvnější znak { nebo [. Je-li to objekt, čtěte ho jako pojmenovaná pole; je-li to pole, čtěte ho jako seznam a pak sestupujte úroveň po úrovni. Syntaktický diagram na json.org se vejde na jednu stránku právě proto, že dvě struktury plus rekurze pokrývají všechno.
Druhé: jak psát objekty, čtyři tvrdá pravidla
Objekty jsou místo, kde začátečníci dělají nejvíc chyb, ale pravidla se redukují na čtyři:
- Klíče musí být řetězce v dvojitých uvozovkách.
{name: "Ada"}i{'name': 'Ada'}jsou oba neplatné; musíte psát{"name": "Ada"}. Objektové literály JavaScriptu umožňují holé klíče a jednoduché uvozovky, JSON ne — to je nejčastější záměna mezi nimi. - Páry oddělujte čárkami a po poslední páru nikdy čárku nenechávejte.
{"a": 1, "b": 2,}selže sUnexpected token }na uzavírací složené závorce. - Klíče by měly být jedinečné. RFC 8259 to formuluje jako SHOULD, nikoli MUST: duplicitní klíče nezpůsobí chybu, ale zda se zachová první nebo poslední hodnota, záleží na implementaci a jazyky se rozcházejí. Nikdy se na to nespoléhejte.
- Pořadí klíčů nemá význam.
{"a":1,"b":2}a{"b":2,"a":1}jsou tentýž objekt; nástroje na diff a porovnávací funkce pořadí klíčů ignorují. Pokud na pořadí záleží, data patří do pole (array).
Třetí: jak psát pole, pořadí je data
Pole (array) ukládají hodnoty podle pozice a indexace začíná na 0: v ["admin", "editor"] je řetězec "editor" [1]. Tohle pořadí je významné — v tom je podstatný rozdíl mezi poli a objekty. Výsledky vyhledávání seřazené podle relevance, záznamy logu seřazené podle data: tato informace žije jen v posloupnosti a převod na objekt ji zničí.
Dvě praktické rady. Zaprvé, udržujte prvky homogenní: [{"id":1},{"id":2}] se konzumuje mnohem snáz než [1, "text", true], který je legální, ale nutí každého konzumenta testovat typy v každém kroku. Zadruhé, prázdné pole [] je zcela platná hodnota — když seznamové pole ještě nemá obsah, vydávejte [] místo null, aby konzument nemusel testovat existenci a pak prázdno.
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
Čtvrté: vnořování, čtyři tvary reálných payloadů
Skutečná data jsou jen tyto dva kontejnery vnořené jeden do druhého a vzory se redukují na čtyři tvary:
| Tvar | Jak vypadá | Typické použití |
|---|---|---|
| Objekt obsahující pole | {"tags": ["a","b"]} |
Seznamové pole entity |
| Pole objektů | [{"id":1},{"id":2}] |
Seznamy záznamů, stránkované výsledky |
| Objekt obsahující objekt | {"db": {"host": "..."}} |
Skupinová konfigurace, adresní bloky |
| Pole polí | [[1,2],[3,4]] |
Matice, řádky tabulky |
Typická odpověď API používá objekt jako obal a pole jako obsah:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
Nevnořujte pro vnořování. Nad tři až čtyři úrovně se přístupové cesty stávají nečitelnými a kód konzumenta narůstá paralelně. Pole, která vždy cestují společně, patří do podobjektu: nahraďte addrCity a addrZip zápisem address: {city, zip}.
Páté: objekt nebo pole, rozhodovací tabulka
| Otázka | Odpověď | Proč |
|---|---|---|
| Má každá hodnota název? | Objekt | Přístup klíčem; přidání či odebrání polí nic nerozbije |
| Je to seznam podobných záznamů? | Pole | Na pořadí záleží; lze mapovat a filtrovat |
| Potřebujete rychlé hledání klíčem? | Objekt indexovaný identifikátorem | Přístup O(1) místo průchodu |
| Více atributů jedné entity? | Objekt | Atributy nemají vlastní pořadí |
| Rostoucí sbírka podobných položek? | Pole | Délka se volně prodlužuje |
Jeden antipattern si zaslouží zvláštní zmínku: napodobit pole objektem s klíči "0", "1", "2". Ten se zparsuje bez chyby, ale ztratíte sémantiku délky a iterační nástroje skutečného pole a konzumenti musí před čtením čehokoli třídit Object.keys. Jsou-li klíče pořadová čísla, pište skutečné pole. Platí i opak: seznam párů klíč/hodnota jako [{"key":"theme","value":"dark"}] je horší než objekt {"theme": "dark"} — ledaže by klíče byly skutečně dynamické a nedaly se předem deklarovat.
Šesté: tři časté chyby a jejich hlášky
| Chybná forma | Typická chyba | Oprava |
|---|---|---|
Koncová čárka {"a":1,} |
Unexpected token } |
Odstranit poslední čárku |
Jednoduché uvozovky / holé klíče {name:'Ada'} |
Unexpected token ' / Expected property name |
Dvojité uvozovky pro klíče a řetězce, vždy |
Literály Pythonu True / None |
Unexpected token T |
Nahradit za true / null |
| Falešné pole s číselnými klíči | Bez chyby, špatná sémantika | Přepsat jako skutečné pole |
Dvě ladicí návyky: parsery obvykle hlásí pozici za viníkem, takže když vidíte position 42, podívejte se o jeden až dva znaky zpět; a obrovský jednořádkový JSON nejdřív naformátujte — čísla řádků a sloupců vždy porazí posuny znaků. Kompletní katalog chyb je v tabulce vyhledávání chyb JSON a krok za krokem postup třídění v jak opravit chyby parsování JSON.
Sedmé: po napsaní ověřte strukturu
Ručně psaný JSON by měl před odevzdáním vždy projít parserem. Nejsnazí kontrola se vejde do jednoho řádku příkazu:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
Online vložte obsah na stránku formátování a validace JSON — syntaktické chyby se vrátí s řádkem a sloupcem. Přepněte do stromového zobrazení a uvidíte typ každé úrovně na první pohled: zda číslo nebylo vyhodnoceno jako řetězec, zda délky polí sedí. A když publikum není technické, payload pole-objektů lze rozprostřít do řádků a sloupců na stránce JSON do tabulky, což mimochodem ověří, že vaše data tvoří skutečně pravidelný seznam záznamů.
Otázky o poli, které mělo být polem (array), nebo o přestavbě příliš hlubokého vnořování patří k modelování typů — další čtení: šest typů, číselná přesnost a pasti kódování.
Dají se pole a objekty JSON vzájemně převádět?
Dají, ale ne bez ztrát. Převod objektu na pole většinou znamená proměnit klíče na hodnoty a ztratit přístup klíčem; převod pole na objekt vyžaduje vymyslet klíč pro každý prvek a původ těchto klíčů je nový konstrukční problém. Rozhodujte podle toho, jak konzument data čte, ne podle syntaktické pohodlnosti.
Mohou se klíče objektu duplikovat?
Syntakticky ano — RFC 8259 říká jen, že klíče BY MĚLY být jedinečné. JavaScript ale uchovává poslední hodnotu, zatímco některé knihovny rodiny C uchovávají první: chování se mezi parsery liší. V podpisech, diffech nebo heších vedou duplicitní klíče k přímým rozporům. Na straně producenta se jim vyhýbejte a duplikáty z neznámého zdroje berte jako riziko na straně konzumenta.
Může pole obsahovat hodnoty různých typů?
Syntakticky ano: [1, "a", true] je platný JSON. Ale heterogenní pole nutí konzumenta testovat typy na každé pozici a v schématu se špatně vyjadřují. Kromě matic a tuplů, kde pozicí je sama sémantika, udržujte pole homogenní.
Proč {name:'json'} nejdle validace?
Protože JSON vyžaduje dvojité uvozovky kolem každého klíče a každé řetězcové hodnoty. {name:'json'} je objektový literál JavaScriptu, ne JSON. Nahraďte ho zápisem {"name": "json"} a validace projde. Jednoduché uvozovky, holé klíče a komentáře patří do dialektů jako JSON5/JSONC, které vyžadují vlastní parsery místo standardního JSON.parse.