CKTIS / JavaScript
JSON.parse: z textu JSON na hodnotu JavaScriptu
JSON.parse načte text podle přísné gramatiky JSON a vrátí jeho hodnotu JavaScriptu; volitelný reviver může výsledek měnit od listů ke kořeni.
Verze: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Syntaxe
JSON.parse(text[, reviver])JSON.parse(text, reviver?) nejprve převede text na řetězec a poté rozpozná právě jednu hodnotu JSON: objekt, pole, řetězec, číslo, true, false nebo null. JSON vyžaduje dvojité uvozovky a nepovoluje komentáře, koncové čárky, undefined, NaN ani Infinity. Klíč "__proto__" se stane běžnou vlastní datovou vlastností; parsování prototyp objektu nemění.
Je-li reviver funkce, engine navštěvuje vlastnosti od potomků k rodiči; this je držitel aktuální vlastnosti a kořen používá prázdný klíč "". Vrácení undefined vlastnost odstraní, jiný výsledek ji nahradí. Od ECMAScript 2026 je třetím argumentem reviveru context; pro nezměněnou primitivní hodnotu obsahuje context.source přesný úsek vstupu, takže lze velké celé číslo obnovit jako BigInt navzdory dřívějšímu zaokrouhlení na Number.
Neplatná syntaxe vyvolá SyntaxError; výjimka z reviveru se šíří dál. JSON.parse nespouští text jako kód, ale data z nedůvěryhodného zdroje je před použitím stále nutné ověřit proti očekávanému schématu. Metoda je standardní od ECMAScript 5, context.source od ECMAScript 2026.
Pří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ýsledek
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true