GameParticles
Développeur

Comment formater et valider du JSON (et corriger les erreurs courantes)

Apprenez à formater, valider et minifier du JSON, à lire les erreurs du parseur et à corriger virgules finales, guillemets simples et texte non échappé.

Mis à jour

Formater du JSON, c'est le réindenter pour que chaque clé figure sur sa propre ligne ; le valider, c'est vérifier qu'il respecte exactement la grammaire JSON. Collez le texte dans un formateur, lisez la première erreur qu'il signale, corrigez ce seul point et relancez. La plupart des JSON cassés comportent l'une d'environ six erreurs, toutes répertoriées ci-dessous.

Ce qu'exige réellement un JSON valide

JSON est plus strict que les littéraux d'objet JavaScript, et c'est de là que vient l'essentiel de la confusion. Les règles qui comptent :

  • Les clés doivent être des chaînes entre guillemets doubles : {"a":1} est valide, {a:1} et {'a':1} ne le sont pas.
  • Les valeurs de type chaîne n'utilisent que des guillemets doubles. "it's" convient ; 'single' non.
  • Pas de virgule finale. [1,2,3,] échoue ; [1,2,3] passe.
  • Pas de commentaires. // note et /* note */ sont tous deux des erreurs.
  • Les littéraux sont en minuscules : true, false, null. True, NULL et undefined ne sont pas valides.
  • Les nombres ne peuvent pas avoir de zéros en tête (007), de signe plus en tête (+5), ni valoir NaN ou Infinity.
  • Le niveau supérieur peut être n'importe quelle valeur, mais la plupart des API attendent un objet {} ou un tableau [].

Si vous gardez ces sept règles en tête, vous repérerez généralement le problème à l'œil nu. Quand ce n'est pas le cas, un validateur vous donne la position exacte.

Comment lire une erreur du parseur

Tout parseur JSON indique la position à laquelle il a abandonné, qui n'est pas forcément celle de l'erreur. Unexpected token } in JSON at position 42 signifie que le parseur a rencontré un } alors qu'il attendait autre chose, en général parce que la ligne précédente se termine par une virgule finale. Unexpected end of JSON input signifie qu'un crochet ou un guillemet a été ouvert sans jamais être refermé. Unexpected token ' signifie presque toujours des guillemets simples.

L'approche pratique : regardez la position signalée, puis reculez d'un élément. Le formateur JSON signale l'erreur directement dans le texte, à cette position, pour que vous n'ayez pas à compter les caractères vous-même.

Corriger les erreurs courantes

Virgules finales

Copier depuis du JavaScript, des dicts Python ou des fichiers de configuration modifiés à la main laisse une virgule après le dernier élément. Supprimez la virgule devant chaque } et chaque ]. Les linters la tolèrent en JS ; JSON, jamais.

Guillemets simples et clés sans guillemets

La sortie de print(dict) en Python, {'name': 'Ada', 'age': 36}, ressemble à du JSON mais n'en est pas. Remplacez ' par " et mettez entre guillemets toutes les clés nues. Si la source est en Python, utilisez json.dumps() au lieu de str() pour obtenir du vrai JSON.

Caractères non échappés dans les chaînes

Un guillemet double ou un saut de ligne littéral à l'intérieur d'une chaîne doit être échappé : "She said \"hi\"" et "line one\nline two". Les barres obliques inverses deviennent elles-mêmes \\ : un chemin Windows s'écrit donc "C:\\Users\\ada". Les tabulations s'écrivent \t, et tout point de code Unicode peut s'écrire sous la forme \u00e9.

Encodage et caractères invisibles

Une marque d'ordre d'octets en début de fichier, des guillemets typographiques collés depuis un document ou une espace insécable entre deux éléments produisent tous des erreurs déroutantes sur une ligne qui semble propre. Retapez les guillemets suspects et enregistrez le fichier en UTF-8 sans BOM.

Documents concaténés ou encapsulés

Les fichiers journaux contiennent souvent un objet JSON par ligne. Le fichier entier n'est pas du JSON valide ; chaque ligne l'est. Découpez sur les sauts de ligne et analysez chaque ligne séparément, ou entourez les lignes de [ et ] en les séparant par des virgules. De même, une réponse d'API encapsulée dans un callback comme cb({...}) est du JSONP : retirez donc d'abord l'appel de fonction.

Mise en forme lisible ou minification

Le JSON mis en forme utilise deux ou quatre espaces par niveau d'imbrication et une clé par ligne : c'est ce qu'il vous faut pour la lecture, les diffs et les fichiers de configuration versionnés dans git. Le JSON minifié supprime tous les espaces pour tenir sur une seule ligne : c'est ce qu'il vous faut sur le réseau ou dans une variable d'environnement. Les deux représentent les mêmes données. JSON.stringify(obj, null, 2) met en forme en JavaScript ; JSON.stringify(obj) minifie. En Python, json.dumps(obj, indent=2) fait le même travail.

Le formatage ne change jamais le sens, mais l'ordre des clés n'est pas garanti par la spécification JSON. N'écrivez pas de code qui compte sur le fait que {"b":1,"a":2} reste dans cet ordre après un aller-retour.

Valider par rapport à un schéma

La validation syntaxique vous dit seulement que le texte est du JSON bien formé. Elle ne vous dit pas que "age" est un nombre ni que "email" est présent. Pour cela, il vous faut JSON Schema, avec un validateur comme Ajv en JavaScript ou jsonschema en Python. Commencez par la syntaxe, car un validateur de schéma ne peut pas s'exécuter sur un texte qui ne s'analyse pas.

Convertir depuis et vers d'autres formats

Les tableurs veulent des lignes et des colonnes, pas des objets imbriqués. Un tableau d'objets plats tel que [{"id":1,"name":"Ada"},{"id":2,"name":"Lin"}] se transpose proprement en CSV avec une ligne d'en-tête, et le convertisseur JSON vers CSV gère les champs entre guillemets et les virgules incluses, dans les deux sens. Les objets imbriqués doivent d'abord être aplatis.

Les fichiers de configuration de Kubernetes, GitHub Actions et Docker Compose sont généralement en YAML. Tout document JSON est aussi du YAML valide, mais l'inverse n'est pas vrai, puisque YAML autorise les commentaires, les ancres et les chaînes sans guillemets. Quand un fichier YAML se comporte mal, le convertir avec le convertisseur YAML vers JSON vous montre exactement comment le parseur a interprété chaque valeur, ce qui révèle la surprise classique de yes qui devient true ou de 3.10 qui devient 3.1.

Le reste des outils de mise en forme, d'encodage et de validation se trouve dans la catégorie développeur.

Essayez

Collez votre JSON en échec dans le formateur JSON. Il s'exécute dans votre navigateur, met l'erreur en évidence à la position exacte et vous permet de passer d'une sortie lisible à une sortie minifiée, avec une largeur d'indentation personnalisée.

Outils de ce guide

Questions fréquentes

Pourquoi mon JSON échoue-t-il avec Unexpected token at position N ?

Le parseur a rencontré à cet emplacement un caractère qu'il n'attendait pas. Regardez un élément avant la position indiquée : une virgule finale, un guillemet simple ou un crochet fermant manquant en est presque toujours la cause.

Les commentaires sont-ils autorisés en JSON ?

Non. Ni // ni /* */ ne font partie de la grammaire JSON. Certains outils les acceptent dans les fichiers de configuration (JSONC, JSON5), mais un parseur standard comme JSON.parse les rejettera.

Formater du JSON, est-ce la même chose que le valider ?

Le formatage réindente du JSON valide pour le rendre lisible. La validation vérifie la syntaxe. Un formateur doit d'abord analyser le texte : il valide donc par effet de bord, mais il ne confronte pas vos données à un schéma.

Comment convertir la sortie d'un dict Python en vrai JSON ?

Utilisez json.dumps(obj) en Python au lieu de str(obj). La forme str utilise des guillemets simples et des littéraux Python comme True et None, qui ne sont pas du JSON valide.

Plus de guides pour développeurs

Formateur JSON
Développeur · Formatez, validez et minifiez du JSON avec coloration syntaxique.
↵
Encoder / décoder en Base64
Développeur · Encodez un texte en Base64 ou décodez du Base64 en texte brut.
↵
Encodeur / Décodeur d'URL
Développeur · Encodez ou décodez des composants d'URL et des chaînes de requête.
↵
Générateur de hash
Développeur · Générez des hashs MD5, SHA-1, SHA-256 et SHA-512.
↵
Générateur d'UUID
Développeur · Générez des UUID v4 (aléatoires) en masse en un clic.
↵
Testeur de regex
Développeur · Testez des expressions régulières sur du texte avec surbrillance des correspondances en direct.
↵
Compteur de mots
Texte · Comptez les mots, caractères, phrases, paragraphes et le temps de lecture.
↵
Convertisseur de casse
Texte · Convertissez un texte en MAJUSCULES, minuscules, Titre, camelCase, snake_case, etc.
↵
Trieur de listes
Texte · Triez, inversez, dédoublonnez et mélangez des listes de texte.
↵
Aperçu Markdown
Texte · Écrivez du Markdown et voyez l'aperçu rendu en direct, côte à côte.
↵
Calculateur de pourcentage
Nombres · Calculez pourcentages, hausses, baisses et le % d'un nombre par rapport à un autre.
↵
Convertisseur de couleurs
Couleurs · Convertissez instantanément des couleurs entre HEX, RGB, HSL et HSV.
↵
Snake
Arcade · Mangez, grandissez, évitez les murs. Un classique indémodable.
↵
2048
Réflexion · Faites glisser les tuiles et fusionnez-les pour atteindre la légendaire tuile 2048.
↵
Word Grid
Réflexion · Devinez le mot caché de cinq lettres en six essais grâce aux indices de couleur.
↵
Sudoku
Réflexion · Remplissez la grille 9x9 par la logique. Quatre niveaux, de facile à expert.
↵
Démineur
Stratégie · Servez-vous des chiffres pour déminer le terrain. Logique classique, trois niveaux.
↵
Breakout
Arcade · Cassez toutes les briques avec la raquette et la balle. Bonus, combos, niveaux sans fin.
↵
Entraînement dactylo
Détente · Améliorez MPM et précision : exercices de 30 secondes à 5 minutes. Repérez vos touches faibles.
↵
TypeRunner
Arcade · Course de dactylographie multijoueur. Défiez vos amis par lien, battez l'ordinateur ou poursuivez votre fantôme.
↵
Typing Blocks
Arcade · Tapez chaque mot avant que son bloc de bois ne se pose. Ratez, et la pile grimpe vers la ligne.
↵
Bubble Shooter
Arcade · Visez, jouez avec les murs et éclatez des groupes de trois bulles ou plus.
↵
Road Rush
Arcade · Affrontez sept rivaux dans le trafic et prenez la tête à coups de poing.
↵