CKTIS / JavaScript
JSON.stringify: JavaScript-waarde naar JSON-tekst
JSON.stringify serialiseert een JavaScript-waarde naar JSON-tekst; een optionele replacer selecteert of verandert gegevens en space bepaalt inspringing.
Versie: ECMAScript 5 onward; well-formed lone-surrogate escaping from ECMAScript 2019; example target: Node.js 24.22.2
Syntax
JSON.stringify(value[, replacer[, space]])JSON.stringify(value, replacer?, space?) geeft een JSON-tekenreeks terug, of undefined wanneer de bovenste waarde undefined, een functie of een Symbol is. Zulke waarden worden in een object weggelaten maar worden in een array null; NaN en oneindigheden worden ook null, terwijl -0 als 0 wordt geschreven. De methode serialiseert eigen opsombare eigenschappen met tekenreekssleutels in de vastgelegde Object.keys-volgorde; Symbol-sleutels worden genegeerd. De beschrijving van eigen opsombare eigenschappen geldt voor de standaardlijst; een replacer-array leest benoemde eigenschappen met Get en kan een geërfde of niet-opsombare opnemen.
Een aanwezige toJSON-methode draait vóór de replacer. Een replacer-functie ontvangt (key, value), met this als houder, en kan de waarde vervangen of een eigenschap weglaten door undefined terug te geven; de wortelaanroep gebruikt de lege sleutel "". Een replacer-array vormt de toelatingslijst van objecteigenschapsnamen. Numerieke space is begrensd op 10 spaties en een tekenreeks op de eerste 10 tekens. Bij tekenreeks-space betekent “10 tekens” exact de eerste 10 UTF-16-code-eenheden.
Een cyclische verwijzing werpt TypeError. Een BigInt werpt eveneens TypeError tenzij gewone eigenschapsopzoeking een aanroepbare toJSON vindt; de methode mag van een prototype komen. Uitzonderingen uit een getter, toJSON of replacer worden doorgegeven. Stabiele eigenschapsvolgorde maakt de uitvoer niet tot canonieke JSON voor cryptografisch ondertekenen. De methode is standaard sinds ECMAScript 5; sinds ECMAScript 2019 worden losse Unicode-surrogaten als \ud800–\udfff-escapes uitgevoerd, zodat het resultaat welgevormd Unicode is.
Voorbeelden
const value = {
name: "Ada",
missing: undefined,
numbers: [1, NaN, Infinity, undefined],
nested: { keep: true, secret: "hidden" },
};
console.log(JSON.stringify(value, (key, current) =>
key === "secret" ? undefined : current,
));
console.log(JSON.stringify(undefined) === undefined);
try {
JSON.stringify(1n);
} catch (error) {
console.log(error instanceof TypeError);
}
const cycle = {};
cycle.self = cycle;
try {
JSON.stringify(cycle);
} catch (error) {
console.log(error instanceof TypeError);
}Resultaat
{"name":"Ada","numbers":[1,null,null,null],"nested":{"keep":true}}
true
true
true