Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

JSON.parse: de texto JSON para um valor JavaScript

JSON.parse lê texto segundo a gramática JSON estrita e devolve o respetivo valor JavaScript; um reviver opcional pode transformar o resultado das folhas para a raiz.

Versão: ECMAScript 5 onward; reviver context.source from ECMAScript 2026; example target: Node.js 24.22.2

Sintaxe

JSON.parse(text[, reviver])

JSON.parse(text, reviver?) converte primeiro text numa string e depois reconhece exatamente um valor JSON: objeto, array, string, número, true, false ou null. JSON exige aspas duplas e não permite comentários, vírgulas finais, undefined, NaN nem Infinity. Uma chave "__proto__" torna-se uma propriedade de dados própria normal; a análise não altera o protótipo.

Se reviver for uma função, o motor visita propriedades dos filhos para o pai; this é o contentor da propriedade atual e a raiz usa a chave vazia "". Devolver undefined elimina uma propriedade; outro resultado substitui-a. Desde ECMAScript 2026, context é o terceiro argumento do reviver; para um primitivo não alterado, context.source contém a parte exata da entrada, permitindo recuperar um inteiro grande como BigInt apesar do arredondamento anterior para Number.

Sintaxe inválida lança SyntaxError; uma exceção lançada pelo reviver propaga-se. JSON.parse não executa o texto como código, mas os dados de uma fonte não fiável continuam a precisar de validação contra o esquema esperado antes da utilização. O método é padrão desde ECMAScript 5 e context.source desde ECMAScript 2026.

Exemplos

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);
}

Resultado

true 2024-01-02T03:04:05.006Z
9007199254740993
b,a,<root>
true

Fontes