Formateur et validateur JSON

Trouver où ça casse

Quand le texte collé ne passe pas, la ligne et la colonne où l’analyseur s’est arrêté sont affichées. Avant de fixer cet endroit, regardez une ligne plus haut. Une virgule en trop ou manquante n’est repérée qu’au jeton suivant : la position signalée tombe donc juste après la vraie faute.

Les coupables habituels sont peu nombreux.

• Une virgule finale après le dernier élément. Tolérée dans les objets JavaScript, interdite en JSON.
• Les apostrophes droites. 'name' n’est pas une chaîne JSON. Les clés comme les valeurs prennent des guillemets doubles.
• Les commentaires. Un fichier de configuration avec // ou /* */ est du JSONC, pas du JSON.
• Les clés sans guillemets. {name: "valeur"} relève de la syntaxe JavaScript.
• NaN et Infinity. Ils ressemblent à des nombres mais ne figurent pas dans la spécification. Ils arrivent souvent par un copier-coller de journal.

Quand minifier

Minifier supprime tous les espaces facultatifs et met le document sur une seule ligne. C’est la forme qu’il faut pour la coller dans une valeur de configuration, la loger dans une variable d’environnement ou l’envoyer comme corps de requête curl. Cela réduit aussi le poids, mais les serveurs compressent déjà les réponses en gzip, donc la taille justifie rarement le geste.

Pour un fichier destiné à un dépôt, gardez l’indentation. Un fichier minifié transforme un changement d’un caractère en un diff du document entier, et plus personne ne peut relire ça.

Ordre des clés et espaces

La mise en forme conserve l’ordre de vos clés. La spécification affirme que l’ordre des clés d’un objet n’a pas de sens, mais en pratique presque tous les analyseurs respectent l’ordre d’insertion : cet outil n’y touche donc pas.

Deux espaces est l’indentation la plus répandue ; quatre accompagne souvent l’outillage Python. Les tabulations économisent quelques octets mais s’affichent avec des largeurs variables selon l’éditeur. Dans un dépôt partagé, alignez-vous sur ce qui existe déjà.

Coller des jetons et de vraies réponses

Rien de ce que vous collez n’est envoyé ailleurs. Le texte est analysé puis resérialisé dans votre navigateur : une réponse pleine de données clients ou un jeton d’accès ne quittent pas la machine. Certaines entreprises interdisent malgré tout les outils externes quel que soit leur fonctionnement ; s’il s’agit de données de production, vérifiez d’abord la règle interne.