CKTIS / JavaScript
JSON — analizzare e serializzare dati
JSON è l’oggetto integrato di JavaScript per leggere e scrivere testo JSON. JSON.parse crea valori a partire dal testo, mentre JSON.stringify serializza i valori, ma non conserva tutti i tipi né tutte le strutture degli oggetti JavaScript.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])JSON è un oggetto integrato di ECMAScript, non un costruttore né una funzione: non usare new JSON() né JSON(). Il formato JSON descrive oggetti, array, stringhe, numeri, valori booleani e null. I nomi delle proprietà e le stringhe devono essere racchiusi tra virgolette doppie; commenti e virgole finali non sono ammessi.
JSON.parse(text, reviver) legge il testo; una sintassi non valida causa un SyntaxError. Il reviver facoltativo trasforma i valori dagli elementi annidati verso la radice; se restituisce undefined, la proprietà viene eliminata. Un’analisi riuscita non convalida lo schema di dati previsto e gli interi grandi possono perdere precisione se rappresentati come valori Number.
JSON.stringify(value, replacer, space) restituisce testo oppure undefined. replacer può essere una funzione che trasforma i valori o un array di nomi che seleziona le proprietà degli oggetti; space controlla il rientro. Per gli oggetti che non sono array, per impostazione predefinita vengono serializzate le proprietà proprie ed enumerabili con chiavi stringa. Per gli array si leggono i valori agli indici da 0 a length - 1, anche se le proprietà corrispondenti sono ereditate o non enumerabili. Le proprietà aggiuntive i cui nomi non sono indici vengono ignorate, anche se enumerabili. Un metodo toJSON, se presente, può modificare la rappresentazione.
Negli oggetti, le proprietà con valore undefined, una funzione o un simbolo vengono omesse, mentre gli elementi corrispondenti degli array diventano null. Anche NaN e gli infiniti diventano null. I cicli e i valori BigInt non convertiti causano un TypeError. Di conseguenza, serializzare e poi analizzare di nuovo non è un metodo generico per creare copie profonde.
Questa voce e l’esempio trattano i metodi di base, non l’intero insieme delle estensioni più recenti. La bozza attuale della specifica descrive anche JSON.rawJSON e JSON.isRawJSON; prima di usarli, verifica che siano disponibili nell’ambiente di destinazione. Un risultato in Node 24 non dimostra il supporto nei browser.
Esempi
const text = '{"name":"Ada","scores":[3,5]}';
const data = JSON.parse(text);
data.scores.push(8);
console.log(JSON.stringify(data));
console.log(JSON.stringify({ missing: undefined, items: [undefined] }));Risultato
{"name":"Ada","scores":[3,5,8]}
{"items":[null]}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.