A classe JSON possui métodos para conversão de JSON para um objeto e vice-versa. Para acompanhar esta parte do tutorial é necessário ter conhecimento do formato.

A classe JSON não possui construtor e propriedades. Os seus métodos são estáticos e são utilizados sem instanciar um objeto.

O objeto JSON possui apenas dois métodos para manipular o formato de dados JSON: parse e stringfy.

O método estático parse, faz a análise uma string em relação aos critérios do formato JSON e constrói um objeto JavaScript que é retornado.

Sintaxe

JSON.parse(text);

Onde

text: string contendo valores no formato JSON

Retorno

Objeto javascript baseado em text ou undefined em caso de erro

Exemplo 1

let str = '{"nome":"tênis", "valor":1.99}';
let obj = JSON.parse(str);
console.log(obj.nome);
console.log(obj.valor);

Saída

tênis
1.99

O método estático stringfy faz o oposto do método parse. O stringfy converte um objeto JavaScript para uma string no formato JSON.

Sintaxe

JSON.stringfy(text);

JSON.stringify(value, replacer)
JSON.stringify(value, replacer, space)

Onde

text: string contendo valores no formato JSON
replacer: Função callback que altera o comportamento do processo de conversão para string

Retorno

Um string contendo informações no formato JSON.

Exemplo 2

let obj = { nome:"tênis", valor:1.99};
let strJSON = JSON.stringify(obj);
console.log(strJSON);

Saída

tênis
1.99

O método estático rawJSON cria um objeto contendo um valor de um campo de um JSON. Seu retorno deve ser validado por isRawJSON.

Sintaxe

JSON.rawJSON(string);

Onde

string: string contendo valor 

Retorno

Objeto contendo string contendo valor no formato JSON.

Exemplo 3

let valor = JSON.rawJSON('"uma string"');
let objJSON = JSON.stringify({ campo: valor });
console.log(objJSON);

Saída

{"campo":"uma string"}

O método estático IsRawJSON é utilizado para verificar se o objeto retornado pelo método rawJSON é válido.

Sintaxe

JSON.isRawJSON(value);

Onde

value: objeto retornado por rawJSON 

Retorno

true value é válido, false caso contrário.

Exemplo 4

let valor = JSON.rawJSON('"uma string"');
console.log(valor);
console.log(JSON.isRawJSON(valor));

Saída

[Object: null prototype] { rawJSON: '"uma string"' }
true

1. 19/08/2025 - revisão 3 - Ajustes: pontuais e sintaxes
2. 25/09/2024 - revisão 2 - Ajustes pontuais
3. 06/10/2023 - revisão 1 - Correção navegação, layout e erros gramaticais
4. 31/05/2023 - versão inicial