Como usar JSON.parse() e JSON.stringify()

Introdução

O objeto JSON, disponível em todos os navegadores modernos, possui dois métodos úteis para lidar com o conteúdo formatado em JSON: parse e stringify. JSON.parse() recebe uma string JSON e a transforma em um objeto JavaScript. JSON.stringify() recebe um objeto JavaScript e o transforma em uma string JSON.

Vejamos um exemplo:

const myObj = {
  name: 'Skip',
  age: 2,
  favoriteFood: 'Steak'
};

const myObjStr = JSON.stringify(myObj);

console.log(myObjStr);
// "{"name":"Sammy","age":6,"favoriteFood":"Tofu"}"

console.log(JSON.parse(myObjStr));
// Object {name:"Sammy",age:6,favoriteFood:"Tofu"}

E, embora os métodos sejam geralmente usados em objetos, eles também podem ser usados em arrays:

const myArr = ['bacon', 'lettuce', 'tomatoes'];

const myArrStr = JSON.stringify(myArr);

console.log(myArrStr);
// "["shark","fish","dolphin"]"

console.log(JSON.parse(myArrStr));
// ["shark","fish","dolphin"]

JSON.parse()

JSON.parse() pode receber uma função como um segundo argumento que transforma os valores do objeto antes de serem retornados. Aqui, os valores do objeto são transformados em maiúsculas no objeto retornado do método parse.

const user = {
  name: 'Sammy',
  email: 'Sammy@domain.com',
  plan: 'Pro'
};

const userStr = JSON.stringify(user);

JSON.parse(userStr, (key, value) => {
  if (typeof value === 'string') {
    return value.toUpperCase();
  }
  return value;
});

JSON.stringify()

JSON.stringify() pode receber dois argumentos adicionais, sendo o primeiro uma função replacer e o segundo um valor String ou Number a ser usado como um space na string retornada.

A função replacer pode ser usada para filtrar valores, pois qualquer valor retornado como undefined estará fora da string retornada:

const user = {
  id: 229,
  name: 'Sammy',
  email: 'Sammy@domain.com'
};

function replacer(key, value) {
  console.log(typeof value);
  if (key === 'email') {
    return undefined;
  }
  return value;
}

const userStr = JSON.stringify(user, replacer);
// "{"id":229,"name":"Sammy"}"

E um exemplo com um argumento passado como space:

const user = {
  name: 'Sammy',
  email: 'Sammy@domain.com',
  plan: 'Pro'
};

const userStr = JSON.stringify(user, null, '...');
// "{
// ..."name": "Sammy",
// ..."email": "Sammy@domain.com",
// ..."plan": "Pro"
// }"

Conclusão

Neste tutorial, você aprendeu a como usar os métodos JSON.parse() e JSON.stringify(). Se você gostaria de aprender mais sobre como trabalhar com JSON no Javascript, confira nosso tutorial Como trabalhar com JSON no JavaScript.

Para mais informações sobre a programação em JavaScript, dê uma olhada em nossa série Como programar em JavaScript ou confira nossa página do tópico JavaScript para exercícios e projetos de programação.