Comment valider du JSON en ligne (et ce que veut dire chaque message d'erreur)
Validez du JSON en ligne et comprenez l'erreur : virgules finales, guillemets simples, clés sans guillemets, commentaires, BOM, clés en double, longs nombres.
Mis à jour le 8 novembre 202611 min de lecture
Pour valider du JSON, collez-le dans le validateur JSON ou déposez-y le fichier .json, puis cliquez sur Valider. Un JSON valide obtient un verdict vert avec son type racine et sa structure. Un JSON invalide obtient un verdict rouge et la liste de toutes les erreurs d'un coup, chacune avec sa ligne, sa colonne et un caret sous le caractère exact. Le plus difficile n'est généralement pas de savoir que quelque chose cloche, mais de comprendre le message, car chaque programme le formule différemment. Ce guide explique ce que signifient les messages courants, quelles « erreurs » relèvent en fait d'un autre dialecte de JSON, pourquoi un fichier parfait échoue à la position 0, et quels sont les deux problèmes qui passent tous les parseurs sans bruit.
Valider du JSON en ligne, étape par étape
Collez le JSON ou ajoutez le fichier
Ouvrez le validateur JSON et collez le texte dans l'éditeur, ou déposez un fichier. Il accepte .json, .jsonc, .json5, .ndjson, .jsonl, .geojson, .webmanifest, .har, .map et .txt. Le JSON minifié comme le JSON indenté fonctionnent.
Laissez le type de document sur Auto
Auto lit le texte comme un seul document JSON. S'il ressemble à un enregistrement par ligne, l'outil propose de le vérifier en NDJSON au lieu de changer de mode de lui-même.
Cliquez sur Valider
En cas de succès, vous voyez le type racine (objet, tableau, etc.), le nombre de clés ou d'éléments et un rapport de structure : nœuds, profondeur maximale, objets, tableaux, clés, lignes, taille et encodage lu. En cas d'échec, chaque erreur s'affiche avec Ln et la colonne ; cliquez sur Aller pour y placer le curseur.
Lisez aussi les avertissements
Les clés en double et les nombres qui perdent en précision apparaissent comme avertissements. Ils ne changent pas le verdict, puisque tout parseur les accepte, mais c'est là que des données disparaissent sans prévenir.
Corrigez à la main ou prenez la copie réparée
Si les seuls problèmes sont des commentaires, des virgules finales, des guillemets simples et autres, une copie réparée en JSON strict est proposée. Cliquez sur Utiliser le JSON réparé pour la charger dans l'éditeur, ou sur Télécharger le .json réparé.
Ce que veulent vraiment dire les messages d'erreur JSON
Chaque langage et chaque application formule à sa façon la même poignée de fautes, et la position indiquée est l'endroit où le parseur a abandonné, souvent un caractère après votre erreur. Ce tableau traduit les messages anglais typiques que vous croiserez ailleurs en leur cause et en message affiché par le validateur.
| Message typique ailleurs | Ce qu'il signifie en général | Ce que dit le validateur |
|---|---|---|
| « Expected double-quoted property name » ou « Expecting property name enclosed in double quotes » | Une virgule finale avant }, une clé entre guillemets simples ou sans guillemets | Une virgule finale avant la fermeture ; ou : la clé n'est pas entre guillemets |
| « Unexpected token » ou « Expecting value » | Quelque chose qui n'est pas une valeur JSON : un commentaire, NaN, undefined, True ou un caractère égaré | JSON n'accepte pas les commentaires ; ou : ce n'est pas une valeur JSON |
| « Expecting ',' delimiter » | Deux membres ou éléments sans virgule entre eux | Il manque une virgule avant cette valeur |
| « Unexpected end of JSON input » | Une accolade ou un crochet jamais fermé, ou un texte tronqué | Un objet (ou un tableau) est ouvert et jamais fermé |
| « Unterminated string » ou « Bad control character in string literal » | Un guillemet fermant manquant, ou un vrai saut de ligne ou une tabulation dans une chaîne | Cette chaîne n'est jamais fermée ; ou : un caractère de contrôle doit être échappé |
| « Unexpected non-whitespace character after JSON » ou « Extra data » | Deux documents collés l'un à l'autre, ou un enregistrement par ligne | La valeur JSON se termine avant ceci ; tout ce qui suit est en trop |
| « Unexpected token » à la position 0 ou « Unexpected UTF-8 BOM » | Des octets invisibles avant la première accolade, ou un fichier qui n'est pas du JSON | La marque est retirée et l'encodage est signalé |
La « position » de ces messages compte les caractères à partir de zéro : la position 0 est le tout premier caractère, la position 7 le huitième. Lignes et colonnes se comptent à partir de un. Le validateur vous donne tout cela, plus un décalage en octets pour les scripts, et le calcule lui-même : l'emplacement est donc le même quel que soit votre navigateur.
Toutes les erreurs d'un coup avec ligne, colonne et caret, plus les clés en double, les alertes de précision, JSON Schema et la réparation. Gratuit : du texte collé ou un fichier jusqu'à 25 MB, toutes les vérifications incluses. Pro : jusqu'à 100 fichiers en une passe et des rapports lisibles par machine en JSON et CSV. Tout s'exécute sur votre appareil, pas sur nos serveurs.
Valider du JSONVirgules finales, guillemets simples, clés sans guillemets, commentaires : cassé ou dialecte ?
Beaucoup de fichiers signalés comme JSON invalide ne sont pas abîmés du tout. Ils sont écrits dans un dialecte plus souple que votre éditeur lit sans souci et qu'un parseur strict refuse. Savoir lequel vous avez vous dit s'il faut corriger le fichier ou le programme qui le lit.
- JSONC (JSON avec commentaires) ajoute les commentaires // et /* */ ainsi que les virgules finales. tsconfig.json, .eslintrc et la plupart des fichiers de réglages d'éditeur sont du JSONC. Ils marchent dans l'éditeur et échouent dans une chaîne de traitement qui attend du JSON pur.
- JSON5 autorise en plus les clés sans guillemets, les chaînes entre guillemets simples, les nombres hexadécimaux, un plus ou un point décimal en tête, ainsi que NaN et Infinity.
- Un dictionnaire Python affiché par un script ressemble à du JSON, mais utilise True, False et None, et souvent des guillemets simples.
- Un texte venu d'un traitement de texte peut contenir des guillemets typographiques (“ ”) au lieu de guillemets droits. Ils ont l'air corrects et ne sont pas du JSON.
Quand le texte relève de l'un de ces cas, le validateur le dit en toutes lettres (par exemple que c'est du JSONC et non du JSON cassé) et liste les constructions en cause. La réparation part de ce que l'analyseur a trouvé : un // dans une URL ou une virgule dans une valeur entre guillemets n'est donc jamais touché. NaN et Infinity n'ont pas d'écriture en JSON et deviennent null, et ce changement est signalé. S'il reste de vraies erreurs de syntaxe en plus du dialecte, aucune copie réparée n'est proposée. Pour remettre le résultat en forme lisible, voyez comment formater du JSON en ligne.
Pourquoi un fichier parfait échoue à la position 0 : BOM et UTF-16
Si une erreur pointe la position 0, ligne 1, colonne 1, et que le fichier semble correct, soupçonnez les octets invisibles. Une marque d'ordre des octets UTF-8 (BOM) tient en trois octets, EF BB BF, que certains outils Windows écrivent devant le texte, notamment Out-File de PowerShell, StreamWriter de .NET et l'export UTF-8 d'Excel. Un parseur strict voit un caractère inattendu avant l'accolade ouvrante et rejette un document par ailleurs correct.
L'UTF-16 est pire : Windows PowerShell l'écrit quand aucun encodage n'est précisé et, lu comme de l'UTF-8, il ressemble à un octet NUL après chaque caractère. Le validateur détecte les deux, valide le document comme si la marque n'existait pas et indique l'encodage utilisé dans le rapport de structure. Pour que d'autres programmes lisent le fichier, réenregistrez-le en UTF-8 sans BOM ; dans PowerShell, passez un encodage explicite à la commande qui l'écrit. Un fichier qui n'est pas du texte du tout, comme une image renommée en .json, est refusé avec ce motif plutôt qu'avec une erreur de syntaxe déroutante.
Valide mais faux : clés en double et longs nombres
Deux problèmes ne déclenchent d'erreur dans aucun parseur, et c'est pour cela qu'ils arrivent jusqu'en production. Le premier est la clé en double. JSON autorise la même clé deux fois dans un objet, et le comportement habituel consiste à garder la dernière valeur et à jeter la première sans un mot : {"a": 1, "a": 2} devient discrètement {"a": 2}. Le validateur signale chaque répétition à l'intérieur d'un objet avec un JSON Pointer qui y mène, comme /users/3/email. La même clé dans deux objets différents est normale et n'est pas signalée.
Le second est un nombre trop long pour être stocké exactement. La plupart des parseurs lisent les nombres JSON en virgule flottante 64 bits, qui ne représente exactement les entiers que jusqu'à 9 007 199 254 740 991. 12345678901234567890 revient sous la forme 12345678901234567000, sans la moindre erreur. Les identifiants de base de données, les numéros de commande et les longues décimales en font les frais. Le validateur affiche le littéral exact à côté de la valeur que produira un parseur ; 1e400, qui déborde en Infinity, est signalé lui aussi. La correction se fait du côté de l'émetteur : envoyez ces valeurs sous forme de chaînes. Les deux vérifications sont activées par défaut dans Vérifications supplémentaires et peuvent être désactivées.
Vérifier la forme avec un JSON Schema
Une syntaxe valide signifie seulement que le texte peut être analysé. Savoir s'il contient les champs qu'attend un programme est une autre question, à laquelle répond un JSON Schema. Collez un schéma dans la zone JSON Schema des réglages et le document est vérifié par rapport à lui après la syntaxe. Les drafts 2020-12 et draft-07 sont pris en charge ; le draft est lu dans $schema ou, si le schéma n'en déclare pas, supposé et indiqué. Chaque échec est accompagné d'un JSON Pointer et de sa ligne, avec des messages comme « La propriété obligatoire id est absente » ou « string était attendu, number a été trouvé ».
Deux détails surprennent souvent. Un $ref qui pointe vers un autre serveur est signalé mais pas téléchargé, pour que votre schéma reste sur votre appareil ; intégrez les définitions au schéma lui-même. Et "format": "email" est une note, pas une règle, comme le définissent les deux drafts : une adresse fausse passe donc, sauf si vous cochez Traiter format comme une règle, pas comme une note. Le document doit d'abord être analysable ; un JSON avec des erreurs de syntaxe n'est pas confronté au schéma.
Fichiers de log et un enregistrement par ligne
Les logs, les exports de données et les envois groupés vers une API sont souvent en NDJSON ou JSON Lines : une valeur JSON par ligne. Lu comme un seul document, un tel fichier échoue avec une unique erreur inutile sur du contenu en trop au début de la ligne 2. Passez Type de document sur NDJSON (ou acceptez la suggestion) et chaque ligne est vérifiée comme un enregistrement à part, chaque faute recevant son numéro d'enregistrement en plus de sa ligne et de sa colonne. Le saut de ligne final ne compte pas comme enregistrement, les fins de ligne Windows sont gérées et une ligne vide au milieu est signalée, car le format n'a pas d'enregistrement vide. La validation par schéma s'applique à un document unique : elle n'est donc pas disponible en mode NDJSON.
Limites gratuites et Pro
| Gratuit | Pro | |
|---|---|---|
| Entrée | Du texte collé ou un fichier à la fois | Jusqu'à 100 fichiers en une passe |
| Taille | Jusqu'à 25 MB | Limitée par votre appareil |
| Vérifications | Toutes les erreurs, avertissements, JSON Schema, NDJSON, réparation | Les mêmes |
| Rapport | Rapport texte à copier ou télécharger | Aussi des rapports JSON et CSV, et un ZIP pour un lot |
Tout ce qui décide si un document est valide est gratuit. Si un fichier dépasse la limite et que vous n'en voulez qu'une partie, la visionneuse JSON permet d'en parcourir la structure. Si vos données étaient au départ en YAML ou en CSV, convertissez-les d'abord avec YAML vers JSON ou CSV vers JSON. Si chaque guillemet est précédé d'une barre oblique inverse, le JSON a été stocké dans une chaîne ; retirez l'échappement, puis validez.
Questions fréquentes
Comment vérifier qu'un fichier JSON est valide ?
Collez le texte ou déposez le fichier dans le validateur JSON et cliquez sur Valider. « JSON valide » en vert signifie qu'il respecte la norme JSON (RFC 8259) ; « JSON invalide » en rouge liste chaque erreur avec sa ligne et sa colonne.
Pourquoi mon JSON affiche-t-il « unexpected token » à la position 0 ?
Le plus souvent, le fichier commence par une BOM UTF-8 ou est enregistré en UTF-16 : le parseur rencontre un caractère invisible avant la première accolade. Réenregistrez-le en UTF-8 sans BOM. Plus rarement, le fichier n'est pas du JSON du tout, par exemple une page d'erreur HTML enregistrée en .json.
Les virgules finales sont-elles autorisées en JSON ?
Non. Le JSON standard n'autorise pas de virgule avant } ou ]. JSONC et JSON5 l'autorisent, d'où un même fichier qui marche dans un éditeur et échoue ailleurs. Supprimez la virgule ou prenez la copie réparée que propose le validateur.
Le JSON peut-il contenir des commentaires ?
Pas en JSON standard. Les fichiers avec des commentaires // ou /* */ sont du JSONC. Le validateur nomme le dialecte et peut vous fournir une copie stricte sans les commentaires ; un // à l'intérieur d'une chaîne, comme une URL, reste intact.
Pourquoi mon JSON est-il valide alors qu'il manque des données ?
Regardez les avertissements. Une clé présente deux fois dans un objet ne garde que sa dernière valeur, et un nombre supérieur à 9 007 199 254 740 991 est arrondi à l'analyse. Aucun des deux ne provoque d'erreur, et le validateur signale les deux.
Est-ce sûr de valider ici du JSON privé ?
Oui. La vérification s'exécute sur votre appareil, pas sur nos serveurs : les réponses d'API, les jetons et les fichiers de configuration ne sont pas envoyés. Une fois la page chargée, elle continue de fonctionner sans connexion réseau.