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.
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.
- Les clés DOIVENT être entourées de guillemets doubles :
'name': 'John'est invalide. La forme correcte est"name": "John". - Pas de virgules finales : vous ne pouvez pas laisser une virgule après le dernier élément d'un tableau ou d'un objet.
- 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 !