KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

JSON — gegevens parsen en serialiseren

JSON is het ingebouwde JavaScript-object voor het lezen en schrijven van JSON-tekst. JSON.parse maakt waarden uit tekst, terwijl JSON.stringify waarden serialiseert, maar niet alle JavaScript-typen of objectstructuren behoudt.

Versie: 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 is een ingebouwd ECMAScript-object, geen constructor of functie: gebruik niet new JSON() of JSON(). Het JSON-formaat beschrijft objecten, arrays, tekenreeksen, getallen, booleans en null. Eigenschapsnamen en tekenreeksen moeten tussen dubbele aanhalingstekens staan; opmerkingen en afsluitende komma’s zijn niet toegestaan.

JSON.parse(text, reviver) leest tekst; ongeldige syntaxis veroorzaakt een SyntaxError. De optionele reviver verandert waarden van geneste elementen naar de wortel toe; als deze undefined teruggeeft, wordt de eigenschap verwijderd. Een geslaagde parse controleert niet of de gegevens aan een verwacht schema voldoen, en grote gehele getallen kunnen als Number aan precisie verliezen.

JSON.stringify(value, replacer, space) geeft tekst of undefined terug. replacer kan een functie zijn die waarden omzet, of een array met namen die objecteigenschappen selecteert; space bepaalt de inspringing. Bij objecten die geen arrays zijn, worden standaard eigen, opsombare eigenschappen met tekenreekssleutels geserialiseerd. Bij arrays worden de waarden op de indices 0 tot en met length - 1 gelezen, ook als de bijbehorende eigenschappen overgeërfd of niet opsombaar zijn. Extra eigenschappen waarvan de namen geen indices zijn, worden genegeerd, ook als ze opsombaar zijn. Een aanwezige toJSON-methode kan de weergave wijzigen.

Eigenschappen met de waarde undefined, een functie of een symbool worden in objecten weggelaten, maar zulke array-elementen worden null. Ook NaN en oneindigheden worden null. Cycli en niet-omgezette BigInt-waarden veroorzaken een TypeError. Opnieuw serialiseren en parsen is daarom geen algemene techniek voor diep kopiëren.

Deze invoer en het voorbeeld behandelen de basismethoden, niet alle nieuwere uitbreidingen. Het huidige specificatieconcept beschrijft ook JSON.rawJSON en JSON.isRawJSON; controleer vóór gebruik of ze in je doelomgeving beschikbaar zijn. Een resultaat in Node 24 bewijst niet dat browsers dit ondersteunen.

Voorbeelden

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] }));

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen