CKTIS / JavaScript
JSON — Daten parsen und serialisieren
JSON ist das integrierte JavaScript-Objekt zum Lesen und Schreiben von JSON-Text. JSON.parse erzeugt Werte aus Text, während JSON.stringify Werte serialisiert; dabei bleiben jedoch nicht alle JavaScript-Typen oder Objektstrukturen erhalten.
Version: 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 ist ein integriertes ECMAScript-Objekt, kein Konstruktor und keine Funktion: Verwende weder new JSON() noch JSON(). Das JSON-Format beschreibt Objekte, Arrays, Zeichenfolgen, Zahlen, boolesche Werte und null. Eigenschaftsnamen und Zeichenfolgen müssen in doppelte Anführungszeichen gesetzt werden; Kommentare und abschließende Kommas sind nicht zulässig.
JSON.parse(text, reviver) liest Text ein; eine ungültige Syntax führt zu einem SyntaxError. Der optionale reviver verändert Werte von verschachtelten Elementen aus in Richtung Wurzel; wird undefined zurückgegeben, wird die Eigenschaft gelöscht. Erfolgreiches Parsen prüft kein erwartetes Datenschema, und große Ganzzahlen können als Number an Genauigkeit verlieren.
JSON.stringify(value, replacer, space) gibt Text oder undefined zurück. replacer kann eine Funktion sein, die Werte umwandelt, oder ein Array von Namen, das Objekteigenschaften auswählt; space steuert die Einrückung. Bei Objekten, die keine Arrays sind, werden standardmäßig eigene, aufzählbare Eigenschaften mit Zeichenfolgen als Schlüsseln serialisiert. Bei Arrays werden die Werte an den Indizes von 0 bis length - 1 gelesen, auch wenn die Eigenschaften an diesen Indizes geerbt oder nicht aufzählbar sind. Zusätzliche Eigenschaften, deren Namen keine Indizes sind, werden ignoriert, selbst wenn sie aufzählbar sind. Eine vorhandene toJSON-Methode kann die Darstellung ändern.
Eigenschaften mit dem Wert undefined, einer Funktion oder einem Symbol werden in Objekten ausgelassen; entsprechende Array-Elemente werden jedoch zu null. Auch NaN und Unendlichkeiten werden zu null. Zyklen und nicht umgewandelte BigInt-Werte führen zu einem TypeError. Daher ist erneutes Serialisieren und Parsen keine universell geeignete Methode zum tiefen Kopieren.
Dieser Eintrag und das Beispiel behandeln die grundlegenden Methoden, nicht alle neueren Erweiterungen. Der aktuelle Spezifikationsentwurf beschreibt außerdem JSON.rawJSON und JSON.isRawJSON; prüfe vor ihrer Verwendung die Verfügbarkeit in deiner Zielumgebung. Ein Ergebnis in Node 24 belegt keine Browserunterstützung.
Beispiele
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] }));Ergebnis
{"name":"Ada","scores":[3,5,8]}
{"items":[null]}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.