Le JSON est le format d'échange le plus répandu du web : réponses d'API, fichiers de configuration, exports de données. Il est lisible par les humains, mais aussi très strict, et une seule virgule oubliée ou superflue suffit à le rendre illisible pour un programme. Ce guide explique ses règles, comment diagnostiquer une erreur et comment passer d'un format à l'autre sans abîmer les données.
Les règles à connaître
Un document JSON contient des objets ({"clé": valeur}), des tableaux ([1, 2, 3]), des chaînes de caractères, des nombres, true, false et null. Rien d'autre. Ces règles expliquent presque toutes les erreurs :
- Les clés et les chaînes sont entre guillemets doubles. Les guillemets simples ('a') ne sont pas valides.
- Pas de virgule après le dernier élément d'un objet ou d'un tableau.
- Pas de commentaires. Ni // ni /* */ n'existent en JSON.
- Pas de valeurs spéciales comme NaN, Infinity ou undefined.
- Les clés doivent être entre guillemets, contrairement aux objets JavaScript.
Formater et valider pas à pas
- Collez le JSON dans Formateur JSON ou déposez un fichier (25 millions de caractères au plus). Il est indenté immédiatement, avec 2 espaces, 4 espaces ou une tabulation, et les clés peuvent être triées alphabétiquement à tous les niveaux.
- Parcourez le résultat en code coloré ou en arbre repliable ; pour un gros document, l'arbre n'ouvre que les niveaux utiles et affiche les longues listes par paquets de 100.
- En cas d'erreur, lisez le message : ligne, colonne, extrait avec un repère et cause probable (virgule en trop, guillemets simples, clé sans guillemets, commentaire, NaN).
Pourquoi les grands nombres sont un piège
JavaScript représente tous les nombres par des flottants à double précision : au-delà de 9 007 199 254 740 991 (2⁵³ − 1), les entiers ne sont plus représentés exactement. L'identifiant 12345678901234567890, lu puis réécrit par un programme JavaScript, devient 12345678901234567000. La plupart des outils font ce détour sans le dire. Les nôtres copient les nombres tels que vous les avez écrits : un identifiant de 20 chiffres, 92.50 ou 1E5 ne changent pas. Si vos données contiennent des identifiants longs, mieux vaut les transmettre sous forme de chaînes.
Erreurs fréquentes
- Copier un objet JavaScript (clés sans guillemets, guillemets simples) en croyant que c'est du JSON.
- Laisser une virgule après le dernier élément, héritage d'autres langages.
- Coller du JSON avec des commentaires issus d'un fichier de configuration (JSONC) dans un outil qui exige du JSON strict.
- Ouvrir un CSV dans Excel sans BOM et voir des caractères accentués abîmés.
- Convertir des identifiants de plus de 15 chiffres via un outil qui les arrondit.
Limites honnêtes
- 25 millions de caractères au maximum : au-delà, utilisez un outil en ligne de commande.
- Les clés en double sont signalées et conservées, mais leur sens varie selon le lecteur : évitez-les.
- Un CSV est un format plat : la conversion d'un JSON profondément imbriqué perd en lisibilité.
Questions fréquentes
Pourquoi mon JSON est-il refusé alors qu'il fonctionne en JavaScript ?
Parce qu'un objet JavaScript accepte des clés sans guillemets, des guillemets simples et des virgules finales, ce que le JSON interdit.
Mes données sont-elles envoyées quelque part ?
Non. Formatage, validation et conversion s'exécutent dans votre navigateur.
Comment éviter qu'Excel exécute une formule cachée dans un CSV ?
Notre convertisseur préfixe d'une apostrophe tout texte commençant par =, +, - ou @. Les vrais nombres ne sont pas touchés.
Peut-on mettre des commentaires dans du JSON ?
Non. Pour des configurations commentées, utilisez YAML ou un format dérivé comme JSONC, que les outils JSON stricts refusent.
Quelle indentation choisir ?
2 espaces est la convention la plus répandue pour le web ; 4 espaces ou une tabulation sont aussi courants. C'est affaire de convention d'équipe, le sens des données ne change pas.