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

Le JSON est partout : réponses d’API, fichiers de configuration, réglages d’applications, données exportées. Les ordinateurs le lisent sans peine, les humains beaucoup moins, surtout quand il arrive compressé sur une seule ligne. Et le JSON est strict : une virgule manquante ou un guillemet de travers, et le programme qui le lit abandonne.

Ce guide explique comment formater du JSON pour le rendre lisible, comment le valider et comment corriger les six erreurs à l’origine de la plupart des JSON cassés, avec le formateur et validateur JSON gratuit.

Formater et valider : quelle différence ?

Formater (on dit aussi embellir) ne change que la présentation : on ajoute des retours à la ligne et une indentation pour suivre facilement la structure. Les clés, les valeurs et leur ordre restent exactement les mêmes. Comparez :

{"user":{"id":1024,"name":"Ada Lovelace","roles":["admin","editor"],"active":true}}

{
  "user": {
    "id": 1024,
    "name": "Ada Lovelace",
    "roles": ["admin", "editor"],
    "active": true
  }
}

Valider vérifie que le texte respecte les règles du JSON, pour que n’importe quel programme puisse le lire. Un bon validateur ne se contente pas de dire « invalide » : il indique où se trouve le problème et ce qui ne va pas.

Formater et valider du JSON, étape par étape

1. Ouvrez le formateur JSON.
2. Ajoutez votre JSON. Collez-le dans Entrée JSON, cliquez sur Ouvrir un fichier ou déposez un fichier .json dans le cadre. Cliquez sur Exemple pour essayer avec un modèle.
3. Suivez la vérification en direct. Pendant la saisie, le cadre affiche ✓ Ce JSON est valide ou une erreur avec sa ligne et sa colonne. Aller à l’erreur vous y emmène directement.
4. Choisissez la présentation. Dans Indentation, choisissez 2 espaces, 4 espaces ou Tabulation. Cochez Trier les clés de A à Z pour classer les propriétés par ordre alphabétique.
5. Cliquez sur Formater et valider. Le JSON formaté apparaît à droite, avec un bref résumé de sa structure. Utilisez Copier ou Télécharger pour le récupérer.

Les 6 erreurs JSON les plus courantes et comment les corriger

1. Une virgule après le dernier élément

Beaucoup de langages de programmation l’acceptent, le JSON non. Supprimez la virgule avant un } ou un ] fermant.

// faux
{ "name": "Ada", "age": 36, }

// correct
{ "name": "Ada", "age": 36 }

2. Des guillemets simples

Les textes et les noms de propriété doivent utiliser des guillemets doubles. Les guillemets simples sont une habitude JavaScript, pas JSON.

// faux
{ 'name': 'Ada' }

// correct
{ "name": "Ada" }

3. Des noms de propriété sans guillemets

En JavaScript, on peut écrire name: "Ada" ; en JSON, chaque nom de propriété doit être entre guillemets doubles.

// faux
{ name: "Ada" }

// correct
{ "name": "Ada" }

4. Des commentaires

Le JSON n’accepte aucun commentaire. Supprimez-les, ou gardez vos notes dans un champ séparé comme "_note". (Certains outils acceptent des variantes comme JSONC ou JSON5, mais pas les lecteurs JSON standard.)

// faux
{
  "port": 8080 // the web server
}

// correct
{
  "port": 8080
}

5. Une virgule manquante entre deux éléments

Chaque propriété et chaque élément de tableau doivent être séparés par une virgule. Cela arrive souvent en collant deux parties ensemble.

// faux
{ "name": "Ada" "age": 36 }

// correct
{ "name": "Ada", "age": 36 }

6. Des valeurs que le JSON ne connaît pas

Le JSON ne connaît que les textes, les nombres, true, false, null, les objets et les tableaux. NaN, undefined et True avec une majuscule ne sont pas autorisés.

// faux
{ "score": NaN, "ok": True, "x": undefined }

// correct
{ "score": null, "ok": true, "x": null }

Le validateur reconnaît chacune de ces erreurs et l’explique simplement, avec la ligne et la colonne où elle se trouve.

Deux choses que beaucoup de formateurs font mal

• Les grands nombres. Beaucoup de formateurs en ligne passent le JSON par JavaScript, qui arrondit discrètement les grands identifiants : 9007199254740993 devient 9007199254740992, et 1.10 devient 1.1. Notre formateur garde chaque nombre exactement tel que vous l’avez écrit.
• Les clés en double. Si la même propriété apparaît deux fois dans un objet, la plupart des programmes ne gardent discrètement que la dernière valeur. Le formateur vous prévient pour que vous choisissiez la bonne.

Ce que vous pouvez faire d’autre avec du JSON

• Minifier du JSON : supprimez tous les espaces inutiles pour le rendre le plus léger possible avant de l’envoyer.
• JSON en CSV : ouvrez vos données dans Excel ou Google Sheets.
• JSON en YAML et JSON en XML : pour les fichiers de configuration et les systèmes qui attendent ces formats.
• Vous comparez deux versions ? Formatez-les d’abord, puis utilisez le comparateur de fichiers, comme expliqué dans comment comparer deux fichiers en ligne.

Mon JSON est-il envoyé ?

Non. La mise en forme et la validation se font dans votre navigateur, vos données ne quittent donc jamais votre appareil. C’est important, car un JSON contient souvent des clés d’API, des données clients ou des réglages internes.

Questions fréquentes

2 ou 4 espaces ?

Les deux conviennent, c’est une question de goût. 2 espaces est le choix le plus courant pour le JSON et garde les données très imbriquées plus étroites.

Trier les clés modifie-t-il mes données ?

Non. L’ordre des propriétés d’un objet n’a aucune signification en JSON : un JSON trié contient exactement les mêmes données. Il est simplement plus facile à parcourir et à comparer.

Le JSON peut-il contenir des commentaires ?

Non. Le JSON standard ne les autorise pas. Retirez les commentaires avant d’utiliser le fichier, ou gardez vos notes dans un champ normal.