CKTIS / JavaScript
JSON.parse: JSON-tekst naar een JavaScript-waarde
JSON.parse leest tekst volgens de strikte JSON-grammatica en geeft de JavaScript-waarde terug; een optionele reviver kan het resultaat van bladeren naar wortel omvormen.
Versie: 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?) zet text eerst om in een tekenreeks en herkent daarna precies één JSON-waarde: object, array, tekenreeks, getal, true, false of null. JSON vereist dubbele aanhalingstekens en staat geen commentaar, afsluitende komma’s, undefined, NaN of Infinity toe. Een sleutel "__proto__" wordt een gewone eigen data-eigenschap; het parsen verandert het prototype niet.
Als reviver een functie is, bezoekt de engine eigenschappen van kinderen naar ouder; this is de houder van de huidige eigenschap en de wortel gebruikt de lege sleutel "". undefined retourneren verwijdert een eigenschap, een ander resultaat vervangt haar. Sinds ECMAScript 2026 is context het derde reviver-argument; voor een ongewijzigde primitieve waarde bevat context.source de exacte invoeruitsnede, zodat een groot geheel getal ondanks eerdere afronding naar Number als BigInt kan worden hersteld.
Ongeldige syntaxis werpt SyntaxError; een uitzondering uit de reviver wordt doorgegeven. JSON.parse voert de tekst niet als code uit, maar gegevens uit een niet-vertrouwde bron moeten vóór gebruik nog tegen het verwachte schema worden gevalideerd. De methode is standaard sinds ECMAScript 5, context.source sinds ECMAScript 2026.
Voorbeelden
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);
}Resultaat
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true