CKTIS / JavaScript
JSON.parse: tekst JSON na wartość JavaScript
JSON.parse analizuje tekst w ścisłej składni JSON i zwraca odpowiadającą mu wartość JavaScript, a opcjonalny reviver może przekształcić wynik od liści do korzenia.
Wersja: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Składnia
JSON.parse(text[, reviver])JSON.parse(text, reviver?) najpierw konwertuje text na łańcuch, a następnie rozpoznaje dokładnie jedną wartość JSON: obiekt, tablicę, łańcuch, liczbę, true, false albo null. JSON wymaga podwójnych cudzysłowów i nie dopuszcza komentarzy, końcowych przecinków, undefined, NaN ani Infinity. Klucz "__proto__" zostaje zwykłą własną właściwością danych — parsowanie nie zmienia prototypu obiektu.
Jeżeli reviver jest funkcją, silnik odwiedza właściwości od potomków do rodzica; this jest obiektem zawierającym bieżącą właściwość, a korzeń ma klucz pusty "". Zwrócenie undefined usuwa właściwość, inny wynik ją zastępuje. Od ECMAScript 2026 trzecim argumentem revivera jest context; dla niezmienionej wartości pierwotnej context.source zawiera dokładny fragment wejścia, co pozwala odzyskać dużą liczbę jako BigInt mimo wcześniejszego zaokrąglenia do Number.
Niepoprawna składnia powoduje SyntaxError; wyjątek rzucony przez reviver jest przekazywany dalej. JSON.parse nie wykonuje tekstu jak kod, lecz dane z niezaufanego źródła nadal trzeba sprawdzić względem oczekiwanego schematu przed użyciem. Metoda jest standardowa od ECMAScript 5, a context.source od ECMAScript 2026.
Przykłady
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);
}Wynik
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true