Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

JSON — parsování a serializace dat

JSON je vestavěný objekt JavaScriptu pro čtení a zápis textu JSON. JSON.parse vytváří hodnoty z textu, zatímco JSON.stringify hodnoty serializuje, ale nezachovává všechny typy ani struktury objektů JavaScriptu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])

JSON je vestavěný objekt ECMAScriptu, nikoli konstruktor ani funkce: nepoužívejte new JSON() ani JSON(). Formát JSON popisuje objekty, pole, řetězce, čísla, logické hodnoty a null. Názvy vlastností a řetězce musí být v dvojitých uvozovkách; komentáře a koncové čárky nejsou povoleny.

JSON.parse(text, reviver) čte text; neplatná syntaxe způsobí SyntaxError. Volitelný reviver mění hodnoty od vnořených prvků směrem ke kořeni; vrácením undefined se vlastnost odstraní. Úspěšné parsování neověřuje očekávané datové schéma a velká celá čísla mohou při reprezentaci jako hodnoty Number ztratit přesnost.

JSON.stringify(value, replacer, space) vrací text nebo undefined. replacer může být funkce, která hodnoty mění, nebo pole názvů vybírající vlastnosti objektů; space řídí odsazení. U objektů, které nejsou poli, se ve výchozím nastavení serializují vlastní výčitatelné vlastnosti s řetězcovými klíči. U polí se čtou hodnoty na indexech od 0 do length - 1, i když jsou odpovídající vlastnosti zděděné nebo nevýčitatelné. Další vlastnosti, jejichž názvy nejsou indexy, se ignorují, i když jsou výčitatelné. Případná metoda toJSON může reprezentaci změnit.

Vlastnosti s hodnotou undefined, funkcí nebo symbolem se v objektech vynechají, ale odpovídající prvky polí se změní na null. Také NaN a nekonečna se změní na null. Cykly a nepřevedené hodnoty BigInt způsobí TypeError. Opětovná serializace a parsování proto nejsou univerzální metodou hlubokého kopírování.

Tento záznam a příklad pokrývají základní metody, nikoli všechny novější doplňky. Aktuální návrh specifikace popisuje také JSON.rawJSON a JSON.isRawJSON; před použitím ověřte jejich dostupnost v cílovém prostředí. Výsledek v Node 24 nedokazuje podporu v prohlížečích.

Příklady

const text = '{"name":"Ada","scores":[3,5]}';
const data = JSON.parse(text);
data.scores.push(8);
console.log(JSON.stringify(data));
console.log(JSON.stringify({ missing: undefined, items: [undefined] }));

Výsledek

{"name":"Ada","scores":[3,5,8]}
{"items":[null]}

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje