JSON Toolkit

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.

Začátečník~6 min čteníPublikováno 2026-11-20Aktualizováno 2026-11-20
Úvodní obálka ke strukturám polí a objektů JSON

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:

  1. 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.
  2. Páry oddělujte čárkami a po poslední páru nikdy čárku nenechávejte. {"a": 1, "b": 2,} selže s Unexpected token } na uzavírací složené závorce.
  3. 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.
  4. 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.