Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

JSON — parsovanie a serializácia údajov

JSON je vstavaný objekt JavaScriptu na čítanie a zápis textu JSON. JSON.parse vytvára hodnoty z textu, kým JSON.stringify hodnoty serializuje, ale nezachováva všetky typy ani štruktúry objektov JavaScriptu.

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

Syntax

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

JSON je vstavaný objekt ECMAScriptu, nie konštruktor ani funkcia: nepoužívajte new JSON() ani JSON(). Formát JSON opisuje objekty, polia, reťazce, čísla, logické hodnoty a null. Názvy vlastností a reťazce musia byť v dvojitých úvodzovkách; komentáre a koncové čiarky nie sú povolené.

JSON.parse(text, reviver) číta text; neplatná syntax spôsobí SyntaxError. Voliteľný reviver mení hodnoty od vnorených prvkov smerom ku koreňu; vrátením undefined sa vlastnosť odstráni. Úspešné parsovanie neoveruje očakávanú dátovú schému a veľké celé čísla môžu pri reprezentácii ako hodnoty Number stratiť presnosť.

JSON.stringify(value, replacer, space) vracia text alebo undefined. replacer môže byť funkcia, ktorá mení hodnoty, alebo pole názvov vyberajúce vlastnosti objektov; space určuje odsadenie. Pri objektoch, ktoré nie sú poľami, sa predvolene serializujú vlastné enumerovateľné vlastnosti s reťazcovými kľúčmi. Pri poliach sa čítajú hodnoty na indexoch od 0 po length - 1, aj keď sú príslušné vlastnosti zdedené alebo neenumerovateľné. Ďalšie vlastnosti, ktorých názvy nie sú indexy, sa ignorujú, aj keď sú enumerovateľné. Prípadná metóda toJSON môže reprezentáciu zmeniť.

Vlastnosti s hodnotou undefined, funkciou alebo symbolom sa v objektoch vynechajú, ale zodpovedajúce prvky polí sa zmenia na null. Aj NaN a nekonečná sa zmenia na null. Cykly a neprevedené hodnoty BigInt spôsobia TypeError. Opätovná serializácia a parsovanie preto nie sú univerzálnou metódou hlbokého kopírovania.

Tento záznam a príklad pokrývajú základné metódy, nie všetky novšie rozšírenia. Aktuálny návrh špecifikácie opisuje aj JSON.rawJSON a JSON.isRawJSON; pred použitím si overte ich dostupnosť v cieľovom prostredí. Výsledok v Node 24 nedokazuje podporu v prehliadačoch.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje