KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen