Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti