Formateur JSON
Embellissez, validez et minifiez du JSON dans votre navigateur. Collez vos données, choisissez un style d'indentation et obtenez instantanément un résultat clair et lisible — rien n'est envoyé.
0 lignes · 0 caractères
Indentation
Comment utiliser Formateur JSON
- 1
Collez votre JSON
Collez du JSON minifié, désordonné ou déjà indenté dans le panneau de saisie.
- 2
Choisissez l'indentation
Sélectionnez 2 espaces, 4 espaces ou tabulations pour contrôler l'indentation de la sortie embellie.
- 3
Formatez ou minifiez
Cliquez sur « Formater » pour mettre en forme et valider le JSON, ou sur « Minifier » pour le compacter sur une seule ligne.
- 4
Copiez le résultat
Utilisez le bouton « Copier » pour récupérer la sortie formatée ou minifiée pour votre projet.
Travailler avec le JSON : formatage, validation et les erreurs qui mordent
Ce qu'est réellement le JSON
Le JSON (JavaScript Object Notation) est un format d'échange de données fondé sur le texte qui est devenu la manière par défaut dont les services dialoguent entre eux via HTTP. Malgré son nom, il est indépendant du langage : des analyseurs existent pour tous les langages courants, et le format de transport n'est que du texte UTF-8. Un document est construit à partir d'exactement six types de valeurs — les objets (collections clé/valeur non ordonnées), les tableaux (listes ordonnées), les chaînes, les nombres, les booléens true et false, et null. Tout ce que vous sérialisez, d'une réponse d'API à un fichier de configuration, se décompose en ces six types.
Deux règles font sans cesse trébucher. D'abord, les clés d'un objet doivent être des chaînes entre guillemets doubles — les identifiants nus ne sont pas autorisés, contrairement aux littéraux d'objet JavaScript. Ensuite, le JSON ne fait aucune distinction entre entier et flottant et ne possède aucune syntaxe de commentaire. Un nombre n'est qu'un nombre, et toute note humaine que vous voulez laisser doit vivre à l'intérieur d'une valeur de type chaîne ou être retirée avant l'analyse.
Formater contre minifier
Ce sont deux vues des mêmes données. Le formatage (aussi appelé embellissement ou impression lisible) insère des retours à la ligne et de l'indentation pour que l'imbrication soit visible d'un coup d'œil — c'est ce que vous voulez en lisant une charge utile, en comparant deux réponses dans un gestionnaire de versions ou en collant un exemple dans une documentation. La minification fait l'inverse : elle retire chaque octet d'espace blanc non significatif pour produire une seule ligne compacte, ce que vous expédiez sur le réseau, où chaque kilo-octet coûte en latence et en bande passante.
Les deux directions sont sans perte pour les données elles-mêmes. L'espace blanc entre les jetons n'est jamais significatif en JSON, de sorte que réduire un objet de 40 lignes à une seule ligne puis le redéployer donne des valeurs analysées identiques. La seule chose qui change, c'est le nombre d'octets et la lisibilité, ce qui explique précisément pourquoi cet outil propose les deux boutons plutôt que d'imposer un seul style.
Les erreurs de syntaxe que vous rencontrerez vraiment
L'erreur la plus courante de toutes est la virgule finale — une virgule après le dernier élément d'un tableau ou la dernière paire d'un objet. JavaScript la tolère ; le JSON l'interdit, de sorte qu'une liste qui se termine par une virgule avant le crochet fermant échouera à l'analyse. Juste derrière viennent les guillemets simples à la place des guillemets doubles (les chaînes JSON doivent utiliser des guillemets doubles) et les clés sans guillemets copiées directement depuis du code source JavaScript.
Autres coupables fréquents : un commentaire parasite (// ou de style bloc), qui est valide en JSONC et JSON5 mais pas en JSON strict ; des valeurs comme NaN, Infinity ou undefined, qui n'existent tout simplement pas dans la spécification ; et des caractères de contrôle non échappés tels qu'une tabulation ou un saut de ligne littéral à l'intérieur d'une chaîne. Lorsque le validateur pointe une ligne, examinez un caractère ou deux avant la position signalée — l'analyseur ne remarque souvent le problème qu'au jeton suivant la véritable erreur.
Choisir un style d'indentation
Deux espaces, c'est la norme de fait pour le JSON sur le web et la valeur par défaut émise par la plupart des outils, dont de nombreux linters et formateurs. Quatre espaces se lisent de façon plus aérée pour des structures profondément imbriquées, et les tabulations laissent chaque développeur choisir sa propre largeur d'affichage tout en gardant le fichier identique octet pour octet. La bonne réponse est celle que votre dépôt utilise déjà ; mélanger les styles au sein d'un même projet produit des diffs bruyants et dénués de sens.
L'indentation est purement cosmétique et est écartée dès l'instant où le document est analysé : elle n'affecte donc jamais la justesse. Choisissez une largeur, appliquez-la de façon cohérente et laissez le formateur normaliser tout ce qui est collé depuis une autre source.
Ordre des clés et intégrité des données
Ce formateur réindente et réespace votre document mais ne réordonne pas les clés et n'altère aucune valeur. C'est important parce que, bien que la spécification JSON définisse les objets comme non ordonnés, pratiquement tous les analyseurs réels préservent l'ordre d'insertion, et les consommateurs en aval — tests de capture, charges utiles signées, relecteurs humains lisant un diff — en dépendent souvent. Un outil qui trierait silencieusement les clés pourrait casser une vérification de signature ou enfouir une modification d'une ligne dans un remaniement de cent lignes.
Si vous voulez bel et bien une sortie canonique et triée pour des diffs stables ou du hachage de contenu, c'est une opération délibérée et distincte que vous devez choisir en connaissance de cause — pas un effet secondaire de l'impression lisible. Garder le formatage et le réordonnancement distincts vous assure de toujours savoir exactement ce qui a changé.
Nombres, précision et Unicode
Les nombres JSON sont décimaux et n'ont aucune limite de taille déclarée, mais le moteur JavaScript qui les analyse dans votre navigateur les stocke en virgule flottante sur 64 bits. Cela signifie que les entiers supérieurs à environ neuf billiards (le plafond des entiers sûrs) peuvent perdre en précision lors d'un aller-retour, ce qui explique pourquoi les grands identifiants, les valeurs « snowflake » et les montants monétaires sont souvent transmis sous forme de chaînes plutôt que de nombres bruts. Si l'exactitude compte, mettez la valeur entre guillemets.
Les chaînes sont en Unicode complet. Vous pouvez écrire les caractères directement en UTF-8 ou sous forme de séquences d'échappement antislash-u, et les deux formes s'analysent vers les mêmes points de code. Parce que le format est du texte UTF-8 de bout en bout, les lettres accentuées, les écritures non latines et les emoji survivent au formatage et à la minification sans la moindre altération.
Tout reste dans votre navigateur
Toute l'analyse, la validation et la re-sérialisation s'exécutent localement en JavaScript. Rien de ce que vous collez n'est téléversé, journalisé ou stocké sur un serveur, il est donc sûr de formater des réponses d'API contenant des jetons d'accès, des identifiants internes ou des données clients. Le plafond pratique est la mémoire de votre appareil plutôt qu'une quelconque limite de téléversement, de sorte que de gros exports se formatent sans problème sur une machine raisonnablement équipée.
Une habitude utile : lorsqu'une intégration se comporte mal, collez d'abord la réponse brute ici. Confirmer que la charge utile est du JSON bien formé avant d'accuser votre code distingue un bug de sérialisation d'un bug d'analyse en quelques secondes, et le fait sans laisser fuiter la charge utile où que ce soit.
Questions fréquentes
Quelle est la différence entre Formater et Minifier ?
Le formateur valide-t-il mon JSON ?
Quelles options d'indentation sont disponibles ?
Réordonne-t-il mes clés ou modifie-t-il les données ?
Mon JSON est-il envoyé, et peut-il gérer de gros fichiers ?
Outils similaires
Continuez avec ces outils pratiques