Formateur & validateur JSON

Lire le JSON de quelqu'un d'autre sans perdre patience

La plupart du JSON que vous croisez au travail n'a jamais été pensé pour des yeux humains : une réponse d'API arrive sous la forme d'une seule ligne interminable, un fichier de configuration a été minifié par un script de build, une entrée de log contient une charge utile tassée dedans. La bonne habitude, toute simple, consiste à coller d'abord et à lire ensuite. Une fois mis en forme, l'indentation révèle la structure des données avant même que vous ne lisiez la moindre valeur : la profondeur de l'imbrication, les parties qui sont des tableaux d'éléments répétés et celles qui sont des réglages ponctuels. Ce coup d'œil sur la structure répond souvent à la question tout seul, car le champ que vous cherchiez se trouve en réalité dans un objet différent de celui que vous supposiez. Rien ne change dans les données quand vous les formatez — seuls les espaces changent — la copie formatée peut donc être recollée sans risque là où elle est attendue.

Quand le JSON est valide mais semble quand même bizarre

Deux choses embrouillent régulièrement les gens même après un parsing réussi. La première est le JSON imbriqué dans du JSON : un champ texte dont la valeur est elle-même un fragment de JSON échappé, truffé de séquences antislash-guillemet. Ce n'est pas une corruption — un système a simplement stocké un document sous forme de texte à l'intérieur d'un autre document. Copiez la chaîne interne à part et formatez-la seule pour la lire. La seconde est celle des grands nombres. JSON autorise en théorie des entiers de n'importe quelle taille, mais JavaScript stocke les nombres sous forme de flottants 64 bits, si bien qu'un identifiant de plus de quinze ou seize chiffres peut voir ses derniers chiffres changer silencieusement au moment du parsing. Si vous formatez une charge utile et qu'un long identifiant numérique ressort légèrement différent, voilà pourquoi — et c'est exactement la raison pour laquelle les API bien conçues envoient les longs identifiants sous forme de chaînes de caractères.

À quoi sert vraiment Minifier

Le JSON minifié est fait pour les machines et les espaces réduits : une charge utile collée dans une commande curl, une valeur compressée dans une variable d'environnement ou dans une seule colonne de base de données, une réponse que vous voulez la plus légère possible sur le réseau. Formater et minifier sont deux miroirs parfaits l'un de l'autre — vous pouvez faire naviguer les mêmes données entre les deux toute la journée, seuls les espaces changent jamais. Un flux de travail bien rodé utilise les deux : formater pour lire et modifier, minifier pour envoyer. Et si vos données sont nées sous forme de tableur plutôt que de JSON, le convertisseur CSV vers JSON transforme des lignes en un tableau d'objets — coller son résultat ici est un moyen rapide de confirmer qu'il se parse avant que votre code ne le voie.

Les suspects habituels quand votre JSON ne parse pas

JSON est plus strict que JavaScript : les clés doivent être entre guillemets doubles, pas de virgule finale après le dernier élément, pas de commentaires, et pas de guillemets simples. Le validateur s'exécute pendant que vous tapez et vous indique la ligne et la colonne du premier problème rencontré.