CKTIS / JavaScript
JSON.parse: iz besedila JSON v vrednost JavaScript
JSON.parse prebere besedilo po strogi slovnici JSON in vrne njegovo vrednost JavaScript; izbirni reviver lahko rezultat spreminja od listov do korena.
Različica: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Sintaksa
JSON.parse(text[, reviver])JSON.parse(text, reviver?) najprej pretvori text v niz in nato prepozna natanko eno vrednost JSON: objekt, polje, niz, število, true, false ali null. JSON zahteva dvojne narekovaje ter ne dovoljuje komentarjev, končnih vejic, undefined, NaN ali Infinity. Ključ "__proto__" postane navadna lastna podatkovna lastnost; razčlenjevanje prototipa ne spremeni.
Če je reviver funkcija, pogon obišče lastnosti od otrok proti staršu; this je vsebnik trenutne lastnosti, koren pa uporablja prazen ključ "". Vrnitev undefined lastnost odstrani, drug rezultat jo zamenja. Od ECMAScript 2026 je context tretji argument reviverja; pri nespremenjeni primitivni vrednosti context.source vsebuje natančen odsek vhoda, zato je veliko celo število mogoče obnoviti kot BigInt kljub predhodnemu zaokroževanju v Number.
Neveljavna skladnja sproži SyntaxError; izjema iz reviverja se razširi naprej. JSON.parse besedila ne izvaja kot kode, vendar je treba podatke iz nezaupanja vrednega vira pred uporabo še vedno preveriti glede na pričakovano shemo. Metoda je standardna od ECMAScript 5, context.source pa od ECMAScript 2026.
Primeri
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);
}Rezultat
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true