Formateur JSON

Aperçu du format JSON

JSON (JavaScript Object Notation) est un format léger d’échange de données. Comprendre ses règles est essentiel pour créer et manipuler efficacement des structures de données JSON.

Règles fondamentales

1. Objets
   • Encapsulés entre des accolades { }.
   • Un objet vide : { }.
2. Tableaux
   • Encapsulés entre des crochets [ ].
   • Un tableau vide : [ ].
3. Membres (paires clé-valeur)
   • Les clés doivent être uniques dans un objet et entourées de guillemets doubles ("clé").
     • (Certains analyseurs tolèrent les guillemets simples, mais il est préférable de les éviter pour des raisons de compatibilité.)
   • Les valeurs dépendent de leur type :
     • Chaîne de caractères : entourée de guillemets doubles.
     • Booléen : true ou false.
     • Nombre : conforme aux règles des nombres à virgule flottante double précision ; la notation scientifique est autorisée. Évitez les zéros en tête.
     • Null : représenté par null.
     • Autres types (ex. dates) : convertissez-les en chaînes de caractères pour assurer la compatibilité.
     • Échappez les caractères spéciaux dans les chaînes avec un antislash (\).
4. Règles de syntaxe
   • Séparez les membres d’un objet ou les valeurs d’un tableau par des virgules, sauf après le dernier élément.
   • Extension de fichier : .json.
   • Type MIME : application/json.

Exemple JSON

{
  "anObject": {
    "numericProperty": -122,
    "stringProperty": "An offensive \" is problematic",
    "nullProperty": null,
    "booleanProperty": true,
    "dateProperty": "2011-09-23"
  },
  "arrayOfObjects": [
    { "item": 1 },
    { "item": 2 },
    { "item": 3 }
  ],
  "arrayOfIntegers": [1, 2, 3, 4, 5]
}

JSON en JavaScript

Puisque JSON dérive de JavaScript, il s’intègre parfaitement dans ce langage. Cependant, une manipulation sûre et correcte est cruciale pour éviter erreurs et risques de sécurité.

Analyse des chaînes JSON

Évitez d’utiliser eval()

eval() peut analyser du JSON mais présente des risques de sécurité car il exécute du code JavaScript arbitraire. Ne jamais utiliser cette méthode en production.

Exemple (dangereux – à ne pas utiliser) :

var jsonString = '{"property":"value"}';
var jsonObject = eval('(' + jsonString + ')');
alert(jsonObject.property);

Utilisez plutôt JSON.parse()

JSON.parse() convertit de manière sécurisée une chaîne JSON en objet JavaScript.

Exemple (sécurisé) :

var jsonString = '{"property":"value"}';
var jsonObject = JSON.parse(jsonString);
alert(jsonObject.property);

Création de chaînes JSON

Utilisez JSON.stringify() pour convertir un objet JavaScript en chaîne JSON.

Exemple :

var jsObject = { property: "value" };
var jsonString = JSON.stringify(jsObject);
alert(jsonString); // Output: '{"property":"value"}'

Création directe d’objets JavaScript

Les objets JavaScript peuvent être créés directement en utilisant la syntaxe JSON dans votre code.

Exemple :

var jsonObject = { property: "value" };
alert(jsonObject.property); // Output: 'value'

Bonnes pratiques et recommandations

1. Utilisez toujours des guillemets doubles pour les clés et les chaînes de caractères afin d’assurer une compatibilité maximale.
2. Évitez d’utiliser eval() pour analyser du JSON afin de prévenir les vulnérabilités de sécurité.
3. Échappez les caractères spéciaux dans les chaînes.
4. Utilisez JSON.stringify() et JSON.parse() pour une manipulation JSON sûre et efficace.
5. Validez les données JSON avant de les analyser, surtout si elles proviennent de sources non fiables.