Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła