Developer Tools

Maîtriser le formatage et la validation JSON

Pourquoi un JSON parfaitement formaté est crucial jusqu'à la dernière virgule, et comment repérer les erreurs structurelles courantes.

5 min de lecture

Code editor showing JSON

Javascript Object Notation (JSON) est l'incontestable roi des API modernes et du transfert de données. Cependant, en raison de sa rigueur extrême, une simple virgule mal placée peut faire planter un endpoint de production tout entier.

Dans ce guide, nous aborderons les règles d'or du formatage JSON.

Les règles de syntaxe du JSON

Contrairement aux objets Javascript classiques, le JSON est notoirement implacable. Si vous enfreignez ces règles, le parseur lève une SyntaxError.

  1. Les clés DOIVENT être entourées de guillemets doubles : 'name': 'John' est invalide. La forme correcte est "name": "John".
  2. Pas de virgules finales : vous ne pouvez pas laisser une virgule après le dernier élément d'un tableau ou d'un objet.
  3. Pas de fonctions ni de valeurs undefined : le JSON ne peut stocker que des chaînes de caractères, des nombres, des booléens, des tableaux, des objets et null.

JSON valide vs. JSON invalide

Voyons ce qu'exige le parseur JSON strict.

{
  "user": {
    "id": 1042,
    "isActive": true,
    "roles": ["admin", "editor"],
    "preferences": null
  }
}

Si nous tentions d'écrire ce même objet de manière informelle, comme nous le faisons dans les scripts JS :

// Ceci est du JSON INVALIDE (mais du Javascript valide)
{
  user: {
    id: 1042,
    isActive: true, // virgule finale
  }
}

Pourquoi la validation est importante

Lors de la connexion de microservices, transmettre du JSON invalide signifie que le serveur destinataire retournera une lourde erreur 500, car JSON.parse() échoue de façon catastrophique. Veillez toujours à analyser et formater votre JSON avant de l'intégrer à une application.

Utilisez un outil de formatage automatisé pour valider que vos payloads API sont sécurisés et structurellement corrects !

Prêt à tester vos données ? Rendez-vous sur notre JSON Formatter & Validator pour embellir instantanément vos chaînes brutes !