Formateur et validateur JSON

Comment formater du JSON

1. Collez votre JSON dans la zone de saisie. Ce peut être une seule ligne copiée depuis la réponse d’une API ou un fichier entier.
2. Choisissez Formater pour indenter (2 espaces, 4 espaces ou tabulations) ou Minifier pour supprimer tous les espaces. Le résultat se met à jour pendant que vous tapez.
3. Activez Trier les clés de A à Z pour classer par ordre alphabétique les clés de chaque objet, ce qui facilite la comparaison de deux documents.
4. Si le JSON n’est pas valide, un message rouge indique ce qui ne va pas, avec la ligne et la colonne où l’analyseur s’est arrêté.
5. Cliquez sur Copier pour placer le résultat dans le presse-papiers.

Tout se passe dans votre navigateur avec les fonctions intégrées JSON.parse et JSON.stringify. Rien n’est envoyé : vous pouvez donc coller sans crainte des fichiers de configuration ou des réponses d’API qui contiennent des données privées.

Qu’est-ce que le JSON ?

JSON (JavaScript Object Notation) est un format texte léger pour stocker et échanger des données. Il est utilisé par presque toutes les API web, par des fichiers de configuration comme package.json et par de nombreuses bases de données. Un document JSON est composé de six sortes de valeurs :

• Objets — paires clé/valeur entre accolades, par exemple {"id": 7}. Les clés doivent être des chaînes entre guillemets doubles.
• Tableaux — listes ordonnées entre crochets, par exemple [1, 2, 3].
• Chaînes — du texte entre guillemets doubles. Les caractères spéciaux sont échappés avec une barre oblique inverse, comme \n pour un retour à la ligne.
• Nombres — des entiers ou des décimaux comme 42 ou -3.14. Le séparateur décimal est toujours le point, jamais la virgule, et il n’y a ni zéros en tête ni NaN.
• Booléens — true ou false, en minuscules.
• null — l’absence de valeur (valeur nulle).

Formater ou minifier : un exemple

L’exemple du cadre ci-dessus est minifié. Il compte 68 caractères sur une seule ligne :

{"name":"ToolHub","tools":["json","words"],"free":true,"users":1200}

Après Formater avec 2 espaces, chaque clé se trouve sur sa propre ligne et les valeurs imbriquées sont indentées : vous voyez la structure d’un coup d’œil. Un JSON formaté se lit, se relit dans une demande de fusion (pull request) et se débogue plus facilement. Un JSON minifié est plus léger : sur de gros volumes, retirer les espaces réduit souvent la taille de 10 à 20 %, ce qui compte quand les données transitent de nombreuses fois sur un réseau. Les données elles-mêmes sont identiques dans les deux cas.

Erreurs JSON courantes et comment les corriger

• Virgule en trop à la fin — [1, 2,] est valide en JavaScript, mais pas en JSON. Supprimez la dernière virgule.
• Apostrophes — {'name': 'Ana'} échoue. Les chaînes et les clés doivent utiliser des guillemets doubles.
• Clés sans guillemets — {name: 1} doit s’écrire {"name": 1}.
• Commentaires — le JSON standard n’autorise ni // ni /* */. Supprimez-les ou utilisez un format comme JSONC si votre outil le prend en charge.
• Caractères non échappés — un retour à la ligne ou une tabulation brute à l’intérieur d’une chaîne n’est pas autorisé ; utilisez \n et \t.
• Littéraux incorrects — True, None et undefined viennent d’autres langages. Le JSON n’accepte que true, false et null.
• Virgule comme séparateur décimal — {"prix": 49,90} n’est pas valide. Écrivez {"prix": 49.90}, même si vous utilisez la virgule au quotidien.

Astuce : quand l’erreur pointe une ligne, regardez aussi le caractère juste avant. Une virgule ou un guillemet manquant sur la ligne précédente est souvent la vraie cause, car l’analyseur ne remarque le problème qu’un élément plus loin.

Questions fréquentes