IA sur votre appareil : performant et privé.

Documents

Comment formater du JSON en ligne (et corriger les erreurs qui le cassent)

Collez un JSON brouillon et obtenez un JSON lisible et indenté. Corrigez virgules finales, apostrophes, clés sans guillemets et commentaires ; choisissez l'indentation.

Mis à jour le 1 novembre 20269 min de lecture

Pour formater du JSON, collez-le dans le formateur JSON, choisissez une indentation de 2 espaces, 4 espaces ou une tabulation, puis cliquez sur Formater le JSON. Une seule ligne illisible devient un plan indenté que l'on lit sans effort, et si le JSON est cassé, vous obtenez la ligne et la colonne du problème au lieu d'un échec vague. La même page minifie, trie les clés et répare les fautes courantes. Ce guide explique ce que le formatage change et ne change pas, comment corriger chaque erreur de syntaxe fréquente, quelle indentation choisir et à quoi s'attendre avec de gros fichiers.

Formater, valider ou minifier ?

Vous voulez…UtilisezVous obtenez
Lire ou modifier un document brouillon ou tenant sur une ligneFormateur en mode FormaterDu JSON indenté, avec des retours à la ligne
Savoir si un fichier est valide et où il ne l'est pasValidateurUne liste d'erreurs avec ligne, colonne et un repère
Réduire le JSON avant de l'envoyer ou de le stockerMinifieur ou Minifier dans le formateurUne seule ligne compacte, mêmes données
Rendre deux exports comparablesTrier les clésLe même ordre de clés à chaque fois

Les trois tâches suivent une même règle : les données restent exactement les mêmes et seuls les blancs autour d'elles changent. Formater ajoute des retours à la ligne et de l'indentation, minifier les retire, et valider lit le document sans le modifier.

Formater du JSON, pas à pas

1

Collez ou ajoutez le JSON

Ouvrez le formateur JSON. Déposez un fichier .json, .jsonc, .ndjson, .jsonl ou .txt sur la page, choisissez-en un avec Parcourir les fichiers, ou ouvrez le panneau de collage et collez directement depuis le presse-papiers.

2

Choisissez Formater et une indentation

Sous Sortie, choisissez Formater pour du JSON lisible. Sous Indentation, choisissez 2 espaces, 4 espaces ou Tabulation. Tout ce panneau est gratuit.

3

Lisez le résultat

La vue Texte affiche la sortie colorée. Arbre permet de replier des branches et de copier le chemin de n'importe quelle valeur, et Statistiques indique la profondeur et le nombre d'objets, de tableaux, de chaînes et de nombres.

4

Corrigez les erreurs, s'il y en a

Un document cassé affiche un message, une ligne, une colonne et la ligne fautive avec un repère sous le caractère. Si le problème est de ceux que l'outil sait réparer, cochez Réparer le JSON invalide et il liste chaque modification effectuée.

5

Copiez ou téléchargez

Cliquez sur Copier pour le presse-papiers ou Télécharger pour un fichier. Rien n'est envoyé à un serveur ; tout s'exécute sur votre appareil.

Indentez, minifiez, triez les clés et réparez du JSON cassé, avec toutes les options de formatage incluses. Gratuit : un fichier jusqu'à 25 Mo. Pro : jusqu'à 20 fichiers à la fois, téléchargés dans un seul ZIP. Tout s'exécute sur votre appareil, pas sur nos serveurs.

Formater le JSON

Les erreurs de syntaxe qui cassent le JSON, et comment corriger chacune

Le JSON est plus strict que le JavaScript auquel il ressemble. La plupart des échecs viennent d'habitudes prises dans le code, dans les fichiers de configuration ou dans la sortie de Python. Les voici, à peu près par ordre de fréquence.

ErreurExempleCorrection
Virgule finale{"a": 1,}Supprimez la virgule avant l'accolade ou le crochet fermant
Apostrophes{'a': 'b'}Utilisez des guillemets doubles pour les clés et les chaînes
Clés sans guillemets{a: 1}Mettez chaque clé entre guillemets doubles : {"a": 1}
Commentaires// note ou /* note */Supprimez-les ; le JSON n'a pas de syntaxe de commentaire
Valeurs Python ou JavaScriptTrue, False, None, NaN, undefinedUtilisez true, false et null ; le JSON n'a pas de NaN
Vrai retour à la ligne dans une chaîneUn vrai saut de ligne entre guillemetsÉcrivez-le \n à l'intérieur de la chaîne
Virgule manquante{"a": 1 "b": 2}Ajoutez une virgule entre les membres

Pour les cinq premières, inutile de corriger à la main. Cochez Réparer le JSON invalide et cliquez sur Réparer et formater. La réparation est désactivée par défaut, car c'est une décision qui porte sur vos données : lorsqu'elle est active, la vue Statistiques liste chaque modification, par exemple combien de virgules finales elle a retirées ou combien de chaînes elle a converties des apostrophes aux guillemets doubles, pour que vous vérifiiez votre accord avant de télécharger. Elle ne touche pas à l'intérieur de vos chaînes : une virgule ou un guillemet au sein d'une valeur n'est donc jamais pris pour de la structure.

Si vous préférez voir tous les problèmes avant de rien changer, le validateur JSON continue après la première faute et signale chacune avec sa ligne et sa colonne. Un analyseur ordinaire s'arrête à la première, si bien qu'un fichier comptant quarante erreurs demande quarante tours de correction.

Choisir l'indentation

L'indentation ne modifie que les blancs, jamais les données : le choix dépend donc de qui lira le fichier. Minifier n'a aucune indentation, c'est pourquoi le réglage Indentation est désactivé tant que Minifier est sélectionné.

IndentationIdéale pourContrepartie
2 espacesProjets web, fichiers de configuration, la plupart des documentations d'APICompact ; des données très imbriquées restent parfois difficiles à suivre
4 espacesLire des données très imbriquées, supports pédagogiquesLignes plus larges ; plus de défilement horizontal
TabulationÉquipes dont le guide de style impose les tabulationsLa largeur dépend de l'afficheur, donc le rendu varie d'un éditeur à l'autre
MinifierEnvoyer, stocker ou intégrerLa plus petite taille ; illisible sans formateur

Si le fichier vit dans un dépôt, suivez ce que le reste du projet utilise pour qu'un reformatage ne transforme pas chaque ligne en modification. Sous Fin de ligne, choisissez LF pour la gestion de versions et CRLF uniquement pour les fichiers qui seront ouverts dans le Bloc-notes de Windows.

Trier les clés, doublons et grands nombres

De nombreux formateurs en ligne lisent votre JSON sous forme de valeurs de programme, puis le réécrivent. Cet aller-retour peut altérer les données en silence : un entier supérieur à 9 007 199 254 740 991 est arrondi, si bien qu'un identifiant comme 12345678901234567890 revient sous la forme d'un autre nombre, et une clé répétée ne garde que sa dernière valeur. Ce formateur copie chaque nombre, chaîne et clé de votre texte d'origine caractère par caractère et ne change que les espaces ; les identifiants longs, les zéros finaux et l'ordre des clés sont donc conservés. La vue Statistiques vous indique même combien de nombres auraient perdu en précision avec un formateur ordinaire.

Trier les clés propose Non, A → Z, Z → A et Naturel. L'ordre naturel traite les suites de chiffres comme des nombres, si bien que item2 vient avant item10. Le tri est récursif dans les objets imbriqués, et les tableaux gardent toujours leur ordre, car l'ordre d'un tableau est une information. Triez avant de comparer deux exports et les différences que vous verrez seront de vrais changements de valeur. Pour une comparaison côte à côte, utilisez la comparaison JSON. Clés dupliquées est réglé par défaut sur Garder les deux, la seule option qui ne supprime rien ; Garder la première et Garder la dernière servent à les résoudre volontairement.

Gros fichiers

L'offre gratuite accepte un fichier jusqu'à 25 Mo, ce qui couvre presque toutes les réponses d'API, tous les fichiers de configuration et toutes les exportations. Le formatage s'exécute en arrière-plan pour que la page reste réactive ; pour les très gros documents, l'aperçu montre le début et le téléchargement contient l'ensemble. Une sortie indentée est plus volumineuse que l'entrée, car chaque niveau ajoute des espaces. Formater une charge d'API avec 2 espaces peut presque doubler sa taille : un fichier de 20 Mo peut donc donner un résultat bien supérieur à 30 Mo.

Si un document est profondément imbriqué, l'indentation peut croître très vite et l'outil vous indiquera que le résultat indenté serait trop volumineux à construire. Choisissez alors Minifier. Quand vous voulez seulement trouver quelque chose dans une énorme réponse, la vue Arbre replie les branches pour tout faire tenir sur un écran, et la visionneuse JSON est conçue pour explorer de grands documents. Pro relève la limite par fichier à ce que votre appareil supporte et permet jusqu'à 20 fichiers d'un coup.

Fichiers à un enregistrement par ligne

Les journaux et les exports de bases de données sont souvent au format JSON Lines, aussi appelé NDJSON : une valeur JSON complète par ligne, sans tableau englobant et sans virgules entre les enregistrements. Un formateur ordinaire le déclare invalide parce qu'il y a du contenu après le premier enregistrement. Celui-ci le détecte. Par défaut, chaque enregistrement reste minifié sur sa propre ligne pour que le fichier demeure un JSON Lines valide. Si vous voulez un seul document, réglez JSON Lines sur Tableau unique : les enregistrements sont alors regroupés dans un seul tableau, indenté selon votre choix.

Liste de contrôle quand le JSON ne passe pas

  1. 1Lisez la ligne et la colonne de l'erreur, puis regardez aussi le caractère qui précède ; beaucoup d'erreurs sont signalées là où l'analyseur les a remarquées, pas là où vous les avez faites.
  2. 2Vérifiez les guillemets : chaque clé et chaque chaîne doivent utiliser des guillemets doubles droits, ni simples ni typographiques.
  3. 3Cherchez une virgule après le dernier élément d'un objet ou d'un tableau, et une virgule manquante entre deux éléments.
  4. 4Cherchez les commentaires, True, False, None, NaN et undefined, et remplacez-les par du JSON valide.
  5. 5Assurez-vous que chaque accolade ou crochet ouvrant a son pendant et que le document forme une seule valeur, et non deux collées ensemble.
  6. 6Si le JSON se trouvait dans une chaîne avec une barre oblique inverse devant chaque guillemet, il a été échappé ; utilisez d'abord l'outil d'échappement JSON pour le déséchapper.

Questions fréquentes

Comment formater du JSON en ligne gratuitement ?

Collez votre JSON dans le formateur ou déposez un fichier, choisissez Formater et une indentation de 2 espaces, 4 espaces ou une tabulation, puis cliquez sur Formater le JSON. Toutes les options de formatage sont gratuites pour les fichiers jusqu'à 25 Mo, et vous pouvez copier ou télécharger le résultat.

Comment corriger un JSON invalide ?

Lisez la ligne et la colonne du message d'erreur. Les causes habituelles sont les virgules finales, les apostrophes, les clés sans guillemets, les commentaires et les valeurs Python comme True ou None. Cochez Réparer le JSON invalide pour les corriger automatiquement ; l'outil liste chaque modification pour que vous la vérifiiez.

Quelle différence entre formater et valider du JSON ?

Formater réécrit les blancs pour rendre le document lisible. Valider vérifie seulement que le document est valide et signale chaque erreur avec sa position. Le formateur affiche aussi une erreur de syntaxe quand il ne peut pas lire le fichier ; le validateur est préférable quand vous voulez la liste complète des fautes.

Le formatage modifie-t-il mes données ?

Non. Seuls les espaces, les tabulations et les retours à la ligne changent. Les nombres, les chaînes et l'ordre des clés sont copiés exactement depuis votre texte, y compris les entiers très longs et des nombres comme 1.10, qui ne sont ni arrondis ni réécrits.

Faut-il choisir 2 espaces, 4 espaces ou des tabulations ?

Utilisez ce que le reste de votre projet utilise. Deux espaces sont courants dans les projets web et gardent des lignes courtes, quatre espaces se lisent mieux avec des données très imbriquées, et les tabulations conviennent aux équipes qui les préfèrent. Le choix n'affecte jamais les données.

Puis-je formater un très gros fichier JSON ?

Oui. L'offre gratuite accepte un fichier jusqu'à 25 Mo. Pro relève la limite par fichier à ce que votre appareil supporte et formate jusqu'à 20 fichiers à la fois dans un ZIP. Si l'indentation rendait le résultat trop volumineux, utilisez Minifier.

À lire ensuite

Plus sur Documents →