CKTIS / JavaScript
JSON — analisar e serializar dados
JSON é o objeto integrado de JavaScript para ler e escrever texto JSON. JSON.parse cria valores a partir do texto, enquanto JSON.stringify serializa valores, mas não preserva todos os tipos nem todas as estruturas de objetos JavaScript.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
JSON.parse(text[, reviver])
JSON.stringify(value[, replacer[, space]])JSON é um objeto integrado de ECMAScript, não um construtor nem uma função: não utilize new JSON() nem JSON(). O formato JSON descreve objetos, arrays, cadeias de caracteres, números, valores booleanos e null. Os nomes das propriedades e as cadeias têm de estar entre aspas duplas; não são permitidos comentários nem vírgulas finais.
JSON.parse(text, reviver) lê texto; uma sintaxe inválida provoca um SyntaxError. O reviver opcional transforma valores dos elementos aninhados até à raiz; devolver undefined elimina a propriedade. Uma análise bem-sucedida não valida o esquema de dados esperado, e os números inteiros grandes podem perder precisão quando representados como valores Number.
JSON.stringify(value, replacer, space) devolve texto ou undefined. replacer pode ser uma função que transforma valores ou um array de nomes que seleciona propriedades de objetos; space controla a indentação. Nos objetos que não são arrays, são serializadas, por predefinição, as propriedades próprias e enumeráveis cujas chaves são cadeias. Nos arrays, são lidos os valores nos índices de 0 a length - 1, mesmo que as propriedades correspondentes sejam herdadas ou não enumeráveis. As propriedades adicionais cujos nomes não são índices são ignoradas, mesmo que sejam enumeráveis. Um método toJSON, se existir, pode alterar a representação.
As propriedades com o valor undefined, uma função ou um símbolo são omitidas dos objetos, mas os elementos correspondentes dos arrays passam a null. NaN e os infinitos também passam a null. Ciclos e valores BigInt não convertidos provocam um TypeError. Por isso, serializar e voltar a analisar não é uma técnica geral para criar cópias profundas.
Esta entrada e o exemplo abrangem os métodos principais, não o conjunto completo das extensões mais recentes. O projeto atual da especificação também descreve JSON.rawJSON e JSON.isRawJSON; verifique a disponibilidade no ambiente de destino antes de os utilizar. Um resultado no Node 24 não comprova o suporte nos browsers.
Exemplos
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] }));Resultado
{"name":"Ada","scores":[3,5,8]}
{"items":[null]}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.