CKTIS / JavaScript
JSON.parse: JSON-Text in einen JavaScript-Wert
JSON.parse liest Text nach der strengen JSON-Grammatik und liefert seinen JavaScript-Wert; ein optionaler Reviver kann das Ergebnis von den Blättern zur Wurzel umformen.
Version: 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?) wandelt text zuerst in eine Zeichenkette um und erkennt dann genau einen JSON-Wert: Objekt, Array, Zeichenkette, Zahl, true, false oder null. JSON verlangt doppelte Anführungszeichen und erlaubt weder Kommentare noch nachgestellte Kommas, undefined, NaN oder Infinity. Ein Schlüssel "__proto__" wird zu einer gewöhnlichen eigenen Dateneigenschaft; das Parsen ändert den Objektprototyp nicht.
Ist reviver eine Funktion, besucht die Engine Eigenschaften von den Kindern zum Elternteil; this ist der Halter der aktuellen Eigenschaft, die Wurzel verwendet den leeren Schlüssel "". undefined löscht eine Eigenschaft, ein anderes Ergebnis ersetzt sie. Seit ECMAScript 2026 ist context das dritte Reviver-Argument; bei einem unveränderten primitiven Wert enthält context.source den exakten Eingabeausschnitt, sodass eine große Ganzzahl trotz vorheriger Rundung zu Number als BigInt wiederhergestellt werden kann.
Ungültige Syntax löst SyntaxError aus; eine Ausnahme aus dem Reviver wird weitergereicht. JSON.parse führt den Text nicht als Code aus, doch Daten aus nicht vertrauenswürdiger Quelle müssen vor der Nutzung gegen das erwartete Schema geprüft werden. Die Methode ist seit ECMAScript 5 Standard, context.source seit ECMAScript 2026.
Beispiele
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);
}Ergebnis
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true