CKTIS / JavaScript
JSON.parse: z textu JSON na hodnotu JavaScriptu
JSON.parse načíta text podľa prísnej gramatiky JSON a vráti jeho hodnotu JavaScriptu; voliteľný reviver môže výsledok meniť od listov ku koreňu.
Verzia: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Syntax
JSON.parse(text[, reviver])JSON.parse(text, reviver?) najprv prevedie text na reťazec a potom rozpozná práve jednu hodnotu JSON: objekt, pole, reťazec, číslo, true, false alebo null. JSON vyžaduje dvojité úvodzovky a nepovoľuje komentáre, koncové čiarky, undefined, NaN ani Infinity. Kľúč "__proto__" sa stane bežnou vlastnou dátovou vlastnosťou; parsovanie prototyp objektu nemení.
Ak je reviver funkcia, engine navštevuje vlastnosti od potomkov k rodičovi; this je držiteľ aktuálnej vlastnosti a koreň používa prázdny kľúč "". Vrátenie undefined vlastnosť odstráni, iný výsledok ju nahradí. Od ECMAScript 2026 je tretím argumentom revivera context; pre nezmenenú primitívnu hodnotu obsahuje context.source presný úsek vstupu, takže možno veľké celé číslo obnoviť ako BigInt napriek skoršiemu zaokrúhleniu na Number.
Neplatná syntax vyvolá SyntaxError; výnimka z revivera sa šíri ďalej. JSON.parse nespúšťa text ako kód, ale údaje z nedôveryhodného zdroja treba pred použitím stále overiť proti očakávanej schéme. Metóda je štandardná od ECMAScript 5, context.source od ECMAScript 2026.
Príklady
const value = JSON.parse(
'{"created":"2024-01-02T03:04:05.006Z","count":9007199254740993}',
function (key, current, context) {
if (key === "created") return new Date(current);
if (key === "count") return BigInt(context.source);
return current;
},
);
console.log(value.created instanceof Date, value.created.toISOString());
console.log(String(value.count));
const order = [];
JSON.parse('{"a":{"b":1}}', (key, current) => {
order.push(key || "<root>");
return current;
});
console.log(order.join(","));
try {
JSON.parse('{"trailing":true,}');
} catch (error) {
console.log(error instanceof SyntaxError);
}Výsledok
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true