Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

JSON.parse: z textu JSON na hodnotu JavaScriptu

JSON.parse načíta text podľa prísnej gramatiky JSON a vráti jeho hodnotu JavaScriptu; voliteľný reviver môže výsledok meniť od listov ku koreňu.

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

Syntax

JSON.parse(text[, reviver])

JSON.parse(text, reviver?) najprv prevedie text na reťazec a potom rozpozná práve jednu hodnotu JSON: objekt, pole, reťazec, číslo, true, false alebo null. JSON vyžaduje dvojité úvodzovky a nepovoľuje komentáre, koncové čiarky, undefined, NaN ani Infinity. Kľúč "__proto__" sa stane bežnou vlastnou dátovou vlastnosťou; parsovanie prototyp objektu nemení.

Ak je reviver funkcia, engine navštevuje vlastnosti od potomkov k rodičovi; this je držiteľ aktuálnej vlastnosti a koreň používa prázdny kľúč "". Vrátenie undefined vlastnosť odstráni, iný výsledok ju nahradí. Od ECMAScript 2026 je tretím argumentom revivera context; pre nezmenenú primitívnu hodnotu obsahuje context.source presný úsek vstupu, takže možno veľké celé číslo obnoviť ako BigInt napriek skoršiemu zaokrúhleniu na Number.

Neplatná syntax vyvolá SyntaxError; výnimka z revivera sa šíri ďalej. JSON.parse nespúšťa text ako kód, ale údaje z nedôveryhodného zdroja treba pred použitím stále overiť proti očakávanej schéme. Metóda je štandardná od ECMAScript 5, context.source od ECMAScript 2026.

Prí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ýsledok

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

Zdroje