JSON.parse()

Die Methode JSON.parse() parst einen JSON-String in ein JavaScript-Objekt. Ein optionaler reviver-Parameter kann die Umwandlung noch weiter beeinflussen.

Syntax

JSON.parse(text[, reviver])

Parameter

text

Der String, der als JSON geparst werden soll. Siehe JSON für eine Beschreibung der JavaScript Object Notation.

reviver Optional

Als Funktion beschreibt reviver, wie das Parsing-Ergebnis umgewandelt wird, bevor es zurückgegeben wird.

Rückgabewert

Gibt das konvertierte Object, das aus dem JSON text hervor geht zurück.

Ausnahmen

Wirft einen SyntaxError wenn der String, der eingelesen werden soll, kein valides JSON ist.

Beispiele

JSON.parse() verwenden

JSON.parse('{}');              // {}
JSON.parse('true');            // true
JSON.parse('"foo"');           // "foo"
JSON.parse('[1, 5, "false"]'); // [1, 5, "false"]
JSON.parse('null');            // null

JSON.parse gibt ein gewöhnliches JavaScript-Objekt zurück:

var stuff = JSON.parse('{"name":"John Doe","age":5}');
console.log(stuff.name);
// -> "John Doe"

Den reviver Parameter verwenden

Wenn ein reviver angegeben wird, wird der geparste Wert vor der Rückgabe transformiert. Genauer wird der Wert mit all seinen Eigenschaften (beginnend bei der am tiefsten verwurzelten Eigenschaft bis hinauf zum ursprünglichen Wert) jeweils einzeln durch den reviver gegeben, wobei der Eigenschaften-Name und dessen Wert als Parameter, und das enthaltende Objekt als this übergeben wird. Gibt die reviver Funktion undefined (oder keinen Wert, z.B. weil das Ende der Funktion erreicht wird) zurück, wird die Eigenschaft vom sie enthaltenden Objekt gelöscht. Anderenfalls wird die Eigenschaft auf den Rückgabewert des reviver neu definiert.

Wenn reviver nur einige Werte ändert, muss sichergestellt sein, dass die unveränderten Werte auch zurückgegeben werden, ansonsten werden diese Werte aus dem Ergebnis gelöscht.

JSON.parse('{"p": 5}', (key, value) =>
  typeof value === 'number'
    ? value * 2 // Gibt value * 2 für Zahlen zurück. 
    : value     // Alle anderen Werte werden unverändert zurückgegeben.
);

// { p: 10 }

JSON.parse('{"1": 1, "2": 2, "3": {"4": 4, "5": {"6": 6}}}', (key, value) => {
  console.log(key); // Loggt die Namen der Eigenschaften, der letzte ist "".
  return value;     // Gib den unveränderten Eigenschaftenwert zurück.
});

// 1
// 2
// 4
// 6
// 5
// 3 
// ""

JSON.parse() erlaubt keine abschließenden Kommas

// Beides wirft einen Syntaxfehler
JSON.parse("[1, 2, 3, 4, ]");
JSON.parse("{ \"foo\" : 1, }");

Spezifikationen

Browserkompatibilität

Gecko-spezifische Notizen

Mit Gecko 29 (Firefox 29 / Thunderbird 29 / SeaMonkey 2.26) erzeugt ein falsches JSON eine genauere Fehlermeldung hervor, welche Zeile und Spalte des Fehlers enthält. Das ist nützlich, wenn große JSON-Daten betrachtet werden

JSON.parse('[1, 2, 3,]');
// SyntaxError: JSON.parse: unexpected character at
// line 1 column 10 of the JSON data

Siehe auch

• JSON.stringify()