Formateur JSON vs JSON Repair

Un formateur rend du JSON valide plus lisible. Un outil de réparation tente de transformer du « presque JSON » en JSON valide avant de le formater.

Formatter

Un formatter JSON attend une entrée JSON valide. Il parse le document et l’imprime avec indentation, sauts de ligne et espacement cohérents. Les formatters sont idéaux pour des logs lisibles, des réponses d’APIs, des fixtures, des fichiers de configuration et l’inspection d’objets imbriqués qui parsent déjà correctement.

Validator

Un validator répond à une seule question : est-ce du JSON strict ? Il doit échouer rapidement sur les commentaires, les guillemets simples, les clés sans guillemets, les virgules finales, les littéraux Python et autres syntaxes non JSON. La validation est la bonne première étape quand vous voulez la certitude qu’un autre parser acceptera le document.

Outil de réparation

Un outil de réparation est fait pour le presque-JSON : des données dont la structure visée est claire mais qui contiennent de la syntaxe JavaScript, Python, markdown ou des commentaires humains. La réparation peut convertir le texte en JSON strict, puis formater le résultat pour faciliter l’inspection.

Minifier

Un minifier retire les espaces inutiles d’un JSON valide. Il ne corrige pas les erreurs de syntaxe. Utilisez la minification quand la taille du payload compte ou quand vous copiez une valeur compacte dans une variable d’environnement, un paramètre de query ou un exemple en ligne de commande.

Quel outil choisir

Utilisez Validate quand il vous faut une réponse oui/non. Utilisez Format quand l’entrée est déjà valide mais difficile à lire. Utilisez Repair quand JSON.parse échoue et que la source vient d’un littéral d’objet JavaScript, d’une réponse de LLM, d’une configuration commentée ou d’un extrait édité à la main. Utilisez Diff quand vous avez deux documents valides ou réparés et que vous voulez comprendre ce qui a changé.

Risque de la réparation automatique

Les outils de réparation peuvent corriger la syntaxe, mais ne devraient pas trancher la sémantique métier. Si une réparation modifie des guillemets, des commentaires ou des virgules, l’intention est habituellement claire. Si elle doit deviner un crochet manquant, un nom de champ ou une valeur, relisez attentivement la sortie avant de l’utiliser en production.

Flux de travail pratique

Pour une entrée bordélique : réparez d’abord, formatez ensuite, validez en troisième, et comparez à un exemple connu si le payload influe sur le comportement applicatif. Cette séquence vous donne une sortie lisible sans sauter la vérification finale par parser strict.