Formatez et validez du JSON avec notre outil JSON. Repérez instantanément les erreurs de syntaxe avec des messages clairs.
Le mystère de l'erreur API
Votre API renvoie une erreur 500. Les journaux disent « Unexpected token ». Vous fixez votre JSON pendant dix minutes. Tout semble correct.
Puis vous le voyez : une virgule finale après le dernier élément. Ou des guillemets simples au lieu de doubles. Ou un caractère de nouvelle ligne non échappé.
JSON est exigeant. Une minuscule erreur de syntaxe fait tout échouer. Un bon formateur JSON détecte ces erreurs avant qu'elles ne causent des problèmes.
Qu'est-ce que JSON ?
JSON (JavaScript Object Notation) est un format texte pour stocker et transporter des données. Il est facile à lire et à écrire pour les humains, et facile à analyser pour les machines.
Malgré son nom, JSON est indépendant du langage. Python, Java, Ruby, Go – tous peuvent lire et écrire du JSON. Il est devenu le format universel d'échange de données.
JSON repose sur deux structures : les objets (paires clé-valeur) et les tableaux (listes ordonnées). Elles peuvent être imbriquées pour représenter des données complexes.
Pourquoi formater le JSON ?
Le JSON formaté est beaucoup plus facile à lire. Comparez ces deux exemples :
Non formaté (difficile à lire)
{"name":"John","age":30,"city":"New York","hobbies":["reading","gaming","hiking"]}
Formaté (facile à lire)
{ "name": "John", "age": 30, "city": "New York", "hobbies": [ "reading", "gaming", "hiking" ] }
Erreurs JSON courantes
Voici les erreurs de syntaxe JSON les plus courantes :
- Virgules finales – Pas de virgule après le dernier élément des tableaux ou objets
- Guillemets simples – JSON exige des guillemets doubles pour les chaînes et les clés
- Clés non entre guillemets – Les clés d'objet doivent être entre guillemets doubles
- Commentaires – JSON ne prend pas en charge les commentaires (utilisez JSON5 si vous en avez besoin)
- Caractères non échappés – Les guillemets et sauts de ligne dans les chaînes doivent être échappés
- Valeurs indéfinies – Utilisez null au lieu de undefined
Bonnes pratiques JSON
Suivez ces pratiques pour un JSON propre et fiable :
- Validez toujours – Vérifiez le JSON avant l'analyse, surtout s'il provient de sources externes
- Utilisez une indentation cohérente – 2 ou 4 espaces, jamais de tabulations
- Triez les clés par ordre alphabétique – Rend les diffs plus propres et la revue plus facile
- Minifiez pour la production – Supprimez les espaces pour réduire la taille
- Utilisez des types corrects – Booléens, nombres, chaînes, pas des chaînes qui ressemblent à des nombres
FAQ
Q.Puis-je ajouter des commentaires au JSON ?
A.Le JSON standard ne prend pas en charge les commentaires. Si vous en avez besoin, utilisez JSON5 ou ajoutez un champ _comment à vos objets.
Q.Quelle taille peut atteindre le JSON ?
A.Il n'y a pas de limite fixe, mais des limites pratiques s'appliquent. La plupart des analyseurs gèrent quelques Mo sans problème. Pour de très grosses données, envisagez le JSON en streaming ou des formats alternatifs.
Q.Quelles sont les alternatives à JSON ?
A.YAML est plus lisible pour les humains mais plus lent à analyser. MessagePack est binaire et plus compact. Protocol Buffers est excellent pour les données structurées mais exige des définitions de schéma.
Références
Cet article s'appuie sur les normes industrielles et les bonnes pratiques de sources autoritatives :
- RFC 8259 – The JavaScript Object Notation (JSON) Data Interchange Format : https://www.rfc-editor.org/rfc/rfc8259
Formatez le JSON localement
Formatez, validez et minifiez du JSON dans votre navigateur, conforme RFC 8259.
Conclusion
La plupart des bugs JSON sont des problèmes de formatage et de validation, pas de logique. Formatez et validez localement avec le formateur JSON.