Travailler avec du texte JSON se résume généralement à trois tâches distinctes : le rendre lisible, le rendre compact, ou vérifier qu'il est correct. Ce sont trois opérations séparées, même si elles sont souvent regroupées dans un seul outil.
Mise en forme (pretty-print)
La mise en forme ajoute des indentations, des sauts de ligne et des espaces autour de la ponctuation pour que la structure du JSON soit facile à lire à l'œil. C'est un changement purement esthétique : il n'affecte pas les données, seulement leur présentation.
Minification
La minification supprime tous les espaces, sauts de ligne et indentations superflus, ne laissant que les caractères strictement nécessaires. Cela réduit la taille du fichier, ce qui compte lors de la transmission sur le réseau ou du stockage de gros volumes — la structure des données elle-même ne change pas.
Validation
La validation vérifie si le texte est syntaxiquement du JSON valide. Erreurs typiques qu'elle détecte : une virgule superflue avant une accolade fermante, des guillemets simples au lieu de doubles, des clés d'objet non entre guillemets, des commentaires (que la norme JSON n'autorise pas du tout), ou des accolades non fermées. Un JSON valide est un prérequis pour que la mise en forme ou la minification fonctionnent tout court.
Quand utiliser quoi
- Mise en forme — lors du débogage de réponses d'API ou de l'édition manuelle de fichiers de configuration.
- Minification — avant d'envoyer des données sur le réseau ou de les intégrer dans du code de production.
- Validation — pour diagnostiquer pourquoi un analyseur refuse de lire un fichier JSON.
Le piège des guillemets « intelligents » copiés-collés
Un JSON valide n'autorise que des guillemets droits doubles (") pour délimiter les chaînes. Or les traitements de texte comme Word, ou même certains éditeurs configurés en français, remplacent automatiquement les guillemets droits par des guillemets typographiques (« », ou des guillemets courbes “ ”) dès qu'on tape ou colle du texte. Un rédacteur non technique qui copie une phrase depuis un document Word dans un fichier de configuration JSON — par exemple une valeur comme "description": "Produit “premium”" — introduit ainsi une erreur de syntaxe invisible à l'œil, que seule une validation stricte révèle.
JSON5 et JSONC ne sont pas le même JSON
Certains environnements (par exemple les configs de VS Code ou de TypeScript) acceptent les virgules finales, les commentaires et les clés non entre guillemets — ce sont des extensions JSON5 ou JSONC, pas le JSON standard (RFC 8259). Un validateur configuré pour du JSON strict rejettera à juste titre un tel fichier, même si l'éditeur le « comprend ».