Formateur et validateur JSON

Comment ça marche

Collez du JSON dans le panneau de gauche et la version mise en forme apparaît aussitôt à droite. La présentation règle les retraits : 2 espaces est la valeur par défaut dans la plupart des langages et des éditeurs, 4 espaces rendent les niveaux plus faciles à suivre à l'œil dans des données très imbriquées, et l'option minifiée supprime chaque espace et chaque retour à la ligne pour tout ramener sur une seule ligne. Le tri alphabétique des clés ne se limite pas au premier niveau : il descend dans tous les objets imbriqués, y compris ceux qui se trouvent à l'intérieur d'un tableau, ce qui rend comparables deux versions d'un fichier dont seul l'ordre des champs diffère. Si le texte n'est pas un JSON valide, aucune sortie n'est produite : à la place, la ligne et la colonne où le problème est devenu visible vous sont indiquées. La ligne de résultat compte les lignes entrées et les lignes sorties, si bien que l'effet du dépliage ou de la minification se voit d'un coup d'œil. La sortie se copie ou se télécharge en fichier .json, et le texte que vous collez ne quitte jamais votre navigateur.

Cet outil est aussi connu sous le nom de formater du json, validateur json, json lisible en ligne, embellir du json, minifier du json.

Qu'est-ce que JSON ?

La grammaire du JSON est plus stricte qu'elle n'en a l'air. Les clés doivent être entre guillemets droits, une virgule ne peut pas suivre le dernier élément, les commentaires sont interdits, le signe décimal est toujours un point, et les seules valeurs autorisées sont les objets, les tableaux, les chaînes, les nombres, true, false et null. Cette rigueur est un choix de conception et non un oubli : avec aussi peu de règles, tous les langages lisent le même texte de la même manière. La validité ne concerne toutefois que la grammaire — un document qui s'analyse sans faute peut parfaitement contenir des données fausses.

Qu'est-ce que retrait (indentation) ?

Le retrait décale chaque niveau d'une structure imbriquée d'un nombre fixe d'espaces, de sorte que la hiérarchie se voie d'un coup d'œil. En JSON, il n'a strictement aucun effet sur les données : le même contenu écrit avec deux espaces, avec quatre ou sans aucun espace s'analyse exactement en les mêmes valeurs. Le retrait existe pour la personne qui lit le fichier, et c'est pourquoi déplier un document pendant qu'on l'examine puis le minifier avant de le coller ailleurs n'a rien d'incohérent.

Quelle différence entre formater et minifier ?

Les deux gardent les mêmes données et ne changent que leur apparence. Formater ajoute des retours à la ligne et des retraits pour rendre la structure lisible, ce qu'il vous faut pour examiner un fichier, chercher une panne ou le montrer à quelqu'un. Minifier retire chaque espace inutile et pose le texte sur une seule ligne, ce qui réduit le nombre de caractères et convient à un champ qui n'accepte qu'une ligne. Aucun des deux sens ne perd de structure : un document minifié se redéplie sur les mêmes valeurs, puisque les espaces entre les éléments ne signifient rien pour un analyseur. Seule l'écriture des nombres peut bouger, parce que le texte est analysé puis réécrit au lieu d'être simplement remanié.

Comment lire la ligne et la colonne d'une erreur

Un analyseur JSON signale la panne au premier caractère qui enfreint une règle, et ce n'est généralement pas là que la faute a été commise. Un guillemet resté ouvert, par exemple, n'est détecté qu'au début de la ligne suivante, parce que tout ce qui précède passait encore pour du contenu de chaîne parfaitement légal.

Donc, quand la ligne signalée paraît innocente, lisez celle du dessus. Les coupables habituels sont courts et répétitifs :

• Une virgule après le dernier élément — le JSON ne l'autorise pas
• Des clés sans guillemets, ou avec des apostrophes au lieu de guillemets droits
• Un zéro en tête d'un nombre, ou une virgule comme signe décimal alors qu'il faut un point
• Un crochet ou une accolade laissés ouverts par un copier-coller incomplet

Quel retrait choisir ?

Dépliez quand un humain va lire le JSON : relecture, capture d'écran, pièce jointe d'un rapport d'incident. Deux espaces gardent les lignes courtes ; quatre rendent évident quel champ appartient à quel objet dès que l'imbrication devient profonde.

Minifiez quand le lecteur est une machine : un champ de configuration, une variable d'environnement, une colonne de base de données ou un formulaire qui n'accepte qu'une ligne. Les espaces n'y portent aucune donnée, ils prennent seulement de la place.

Ce qu'un aller-retour ne conserve pas

La mise en forme garde vos données mais ne vous rend pas le fichier octet pour octet. Le texte est analysé en valeurs réelles puis réécrit : 1.0 revient sous la forme 1, 1e3 revient sous la forme 1000, et un entier au-delà d'environ seize chiffres revient arrondi. C'est une propriété de la façon dont les nombres sont tenus en mémoire, et elle vaut pour tout outil JSON bâti sur un analyseur standard, pas seulement pour celui-ci.

Les clés en double sont l'autre cas à connaître. Le JSON autorise le même nom deux fois dans un objet, et les analyseurs gardent la dernière occurrence : la valeur précédente disparaît donc de la sortie sans avertissement. Si vous mettez en forme un fichier où cela pourrait compter — une configuration issue d'une fusion, par exemple — comptez les clés avant de remplacer l'original.

Les accents et les alphabets non latins survivent-ils ?

Oui, et sans transformation. Un texte français, arabe ou berbère traverse la mise en forme tel quel : é reste é, et une chaîne écrite en caractères arabes ressort identique, à la même place. La mise en forme ne touche qu'aux espaces entre les éléments, jamais au contenu des chaînes.

Si vos accents arrivent déjà abîmés dans le panneau de gauche, la cause est en amont : le fichier a été lu avec le mauvais encodage avant d'être collé ici. Rouvrez la source en UTF-8 plutôt que de corriger le résultat à la main.

Un dernier point qui surprend : certains exports écrivent les lettres accentuées sous la forme \u00e9 au lieu de é. Ce n'est pas une erreur, c'est une autre façon parfaitement valide d'écrire le même caractère, et les deux écritures sont lues à l'identique par n'importe quel programme. Cet outil ne les convertit pas d'une forme à l'autre ; il rend ce qu'il a reçu.

Questions fréquentes

Comment rendre un JSON lisible ?

Collez le texte dans le panneau de gauche et choisissez un retrait ; la version mise en forme apparaît à droite au fil de la frappe, prête à copier ou à enregistrer en fichier .json.

Comment savoir si mon JSON est valide ?

Si une sortie apparaît, le texte est un JSON valide. Sinon, un message prend la place de la sortie et nomme la ligne et la colonne où le problème se manifeste.

À quoi sert le tri des clés ?

À comparer deux fichiers. Deux exports qui ne diffèrent que par l'ordre des champs paraissent complètement différents dans une comparaison ; triez les deux et il ne reste à l'écran que les vraies différences.

La mise en forme modifie-t-elle mes données ?

Les valeurs restent les mêmes ; seuls les espaces changent, plus l'ordre des clés si vous le demandez. Le seul point à surveiller est l'écriture des nombres : tout analyseur réécrit 1.0 en 1 et arrondit les entiers au-delà d'environ seize chiffres.

À quoi sert un JSON minifié ?

Les espaces et les retours à la ligne ne signifient rien pour un analyseur JSON, ils occupent seulement de la place. La version sur une seule ligne est celle qu'il vous faut pour un champ de configuration, une variable d'environnement ou tout formulaire qui n'accepte qu'une ligne.