Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

JSON.parse: z textu JSON na hodnotu JavaScriptu

JSON.parse načte text podle přísné gramatiky JSON a vrátí jeho hodnotu JavaScriptu; volitelný reviver může výsledek měnit od listů ke kořeni.

Verze: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2

Syntaxe

JSON.parse(text[, reviver])

JSON.parse(text, reviver?) nejprve převede text na řetězec a poté rozpozná právě jednu hodnotu JSON: objekt, pole, řetězec, číslo, true, false nebo null. JSON vyžaduje dvojité uvozovky a nepovoluje komentáře, koncové čárky, undefined, NaN ani Infinity. Klíč "__proto__" se stane běžnou vlastní datovou vlastností; parsování prototyp objektu nemění.

Je-li reviver funkce, engine navštěvuje vlastnosti od potomků k rodiči; this je držitel aktuální vlastnosti a kořen používá prázdný klíč "". Vrácení undefined vlastnost odstraní, jiný výsledek ji nahradí. Od ECMAScript 2026 je třetím argumentem reviveru context; pro nezměněnou primitivní hodnotu obsahuje context.source přesný úsek vstupu, takže lze velké celé číslo obnovit jako BigInt navzdory dřívějšímu zaokrouhlení na Number.

Neplatná syntaxe vyvolá SyntaxError; výjimka z reviveru se šíří dál. JSON.parse nespouští text jako kód, ale data z nedůvěryhodného zdroje je před použitím stále nutné ověřit proti očekávanému schématu. Metoda je standardní od ECMAScript 5, context.source od ECMAScript 2026.

Příklady

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);
}

Výsledek

true 2024-01-02T03:04:05.006Z
9007199254740993
b,a,<root>
true

Zdroje