JSON.parse()

Experimente

const json = '{"result":true, "count":42}';
const obj = JSON.parse(json);

console.log(obj.count);
// Expected output: 42

console.log(obj.result);
// Expected output: true

Sintaxe

JSON.parse(text[, reviver])

Parmetros

text

A string para analisar como JSON. Veja o objeto JSON para uma descrio da sintaxe JSON.

reviver Optional

Se for uma funo, prescreve como o valor originalmente produzido pela anlise ser transformado antes de ser retornado.

Valor retornado

O Object correspondente ao text JSON fornecido.

Excees

Lana uma exceo SyntaxError se a string a ser analisada no for um JSON vlido.

Exemplos

Usando JSON.parse()

JSON.parse("{}"); // {}
JSON.parse("true"); // true
JSON.parse('"foo"'); // "foo"
JSON.parse('[1, 5, "false"]'); // [1, 5, "false"]
JSON.parse("null"); // null

Usando o parmetro reviver

Se um reviver for especificado, o valor calculado pela anlise ser transformado antes de ser retornado. Especificamente, o valor computado e todas as suas propriedades (comeando com as propriedades mais aninhadas e prosseguindo para o prprio valor original) so executadas individualmente atravs do reviver. Em seguida, ele chamado, com o objeto contendo a propriedade sendo processada como this, e com o nome da propriedade como uma string, e o valor da propriedade como argumentos. Se a funo reviver retornar undefined (ou no retornar nenhum valor, por exemplo, se a execuo cair no final da funo), a propriedade ser excluda do objeto. Caso contrrio, a propriedade redefinida para ser o valor de retorno.

Se o reviver apenas transformar alguns valores e no outros, certifique-se de retornar todos os valores no transformados como esto, caso contrrio, eles sero excludos do objeto resultante.

JSON.parse(
  '{"p": 5}',
  (key, value) =>
    typeof value === "number"
      ? value * 2 // retorna o valor * 2 para nmeros
      : value, // retorna tudo sem alterao
);

// { p: 10 }

JSON.parse('{"1": 1, "2": 2, "3": {"4": 4, "5": {"6": 6}}}', (key, value) => {
  console.log(key); // mostra o nome da propriedade atual, o ltimo  "".
  return value; // retorna o valor da propriedade inalterada.
});

// 1
// 2
// 4
// 6
// 5
// 3
// ""

JSON.parse() no permite vrgulas direta

// ambos retornaro um SyntaxError
JSON.parse("[1, 2, 3, 4, ]");
JSON.parse('{"foo" : 1, }');

Especificaes

Compatibilidade com navegadores

Veja Tambm

• JSON.stringify()