CKTIS / JavaScript
JSON.parse: dal testo JSON a un valore JavaScript
JSON.parse legge testo secondo la grammatica JSON rigorosa e restituisce il valore JavaScript; un reviver facoltativo può trasformare il risultato dalle foglie alla radice.
Versione: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2
Sintassi
JSON.parse(text[, reviver])JSON.parse(text, reviver?) converte prima text in stringa, quindi riconosce esattamente un valore JSON: oggetto, array, stringa, numero, true, false o null. JSON richiede virgolette doppie e non consente commenti, virgole finali, undefined, NaN o Infinity. Una chiave "__proto__" diventa una normale proprietà dati propria; il parsing non cambia il prototipo.
Se reviver è una funzione, il motore visita le proprietà dai figli al genitore; this è il contenitore della proprietà corrente e la radice usa la chiave vuota "". Restituire undefined elimina una proprietà, mentre un altro risultato la sostituisce. Da ECMAScript 2026, context è il terzo argomento del reviver; per una primitiva non modificata, context.source contiene la porzione esatta dell’input, consentendo di recuperare un intero grande come BigInt nonostante il precedente arrotondamento a Number.
Una sintassi non valida genera SyntaxError; un’eccezione del reviver si propaga. JSON.parse non esegue il testo come codice, ma i dati di una fonte non attendibile devono comunque essere convalidati rispetto allo schema atteso prima dell’uso. Il metodo è standard da ECMAScript 5 e context.source da ECMAScript 2026.
Esempi
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);
}Risultato
true 2024-01-02T03:04:05.006Z 9007199254740993 b,a,<root> true