Comment utiliser JSON.parse() et JSON.stringify()

Introduction

L’objet JSON, disponible dans tous les navigateurs modernes, dispose de deux méthodes utiles pour traiter le contenu formaté en JSON : parse et stringify. JSON.parse() transforme une chaîne JSON en un objet JavaScript. JSON.stringify() transforme un objet JavaScript en une chaîne JSON.

Voici un exemple :

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"}

Et bien que les méthodes soient généralement utilisées sur des objets, elles peuvent également être utilisées sur des tableaux :

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() peut prendre une fonction comme second argument, capable de transformer les valeurs de l’objet avant qu’elles ne soient renvoyées. Ici, les valeurs de l’objet sont transformées en majuscules dans l’objet renvoyé de la méthode 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() peut prendre deux arguments supplémentaires, le premier étant une fonction replacer et le second une valeur String ou Number à utiliser en tant que space dans la chaîne renvoyée.

La fonction replacer peut être utilisée pour filtrer les valeurs, car toute valeur renvoyée comme undefined sera exclue de la chaîne renvoyée :

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"}"

Et un exemple avec un argument space passé en revue :

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

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

Conclusion

Dans ce tutoriel, vous avez appris comment utiliser les méthodes JSON.parse() et JSON.stringify(). Si vous souhaitez en savoir plus sur le travail avec JSON en Javascript, consultez notre tutoriel Comment travailler avec JSON en JavaScript.

Pour plus d’informations sur le codage en JavaScript, consultez notre série Comment coder en JavaScript ou notre page thématique JavaScript d’exercices et de projets de programmation.