Formater et valider du JSON (et corriger les 7 erreurs les plus courantes)
Un JSON illisible sur une seule ligne ? Une erreur « Unexpected token » ? Apprenez à indenter, valider et minifier du JSON, et à corriger les erreurs de syntaxe les plus fréquentes.
Le JSON en 30 secondes
Le JSON (JavaScript Object Notation) est le format de données le plus utilisé sur le web : réponses d'API, fichiers de configuration (package.json, tsconfig.json), exports de données, logs. Il repose sur une poignée d'éléments :
{
"nom": "AwesomeToolkit",
"outils": 90,
"gratuit": true,
"langues": ["en", "fr", "es"],
"proprietaire": null
}
Des objets entre accolades, des tableaux entre crochets, des chaînes entre guillemets doubles, des nombres, true, false et null. C'est tout. Et pourtant, une seule virgule mal placée suffit à tout casser.
Formater, valider, minifier : quelle différence ?
| Opération | Ce qu'elle fait | Quand l'utiliser |
|---|---|---|
| Formater (indenter) | Ajoute indentation et retours à la ligne | Lire une réponse d'API, déboguer |
| Valider | Vérifie la syntaxe et localise les erreurs | Avant de committer une config, après une édition à la main |
| Minifier | Supprime tous les espaces inutiles | Production, transfert réseau, intégration dans une URL ou une variable |
Formater du JSON en ligne
Le formateur JSON fait les trois, dans votre navigateur : vous pouvez coller un JSON contenant des tokens, des données clients ou des configurations sans qu'il soit envoyé nulle part.
- Collez votre JSON : il est indenté et coloré.
- Choisissez l'indentation : 2 espaces, 4 espaces ou tabulation.
- En cas d'erreur, l'outil indique la ligne et la colonne exactes et explique le problème.
- Les très grands nombres (au-delà de 2^53, comme certains identifiants) sont conservés tels qu'écrits, là où beaucoup d'outils les arrondissent en silence.
- Les clés en double — valides en théorie, mais source classique de bugs — sont signalées.
Les 7 erreurs JSON les plus courantes
1. La virgule finale
{ "a": 1, "b": 2, }
JavaScript l'accepte, JSON non. Supprimez la dernière virgule.
2. Les guillemets simples
{ 'nom': 'Alice' }
JSON n'accepte que les guillemets doubles, pour les clés comme pour les chaînes.
3. Les clés sans guillemets
{ nom: "Alice" }
Valide en JavaScript, pas en JSON : chaque clé doit être entre guillemets doubles.
4. Les commentaires
{ "port": 8080 // port de dev }
Le JSON standard ne gère pas les commentaires. Certains outils les acceptent (JSONC, utilisé par VS Code), mais pas une API.
5. La virgule manquante entre deux éléments
Souvent après un copier-coller : l'erreur est signalée au début de l'élément suivant, pas à la fin du précédent.
6. Les caractères spéciaux non échappés
Un retour à la ligne ou un guillemet dans une chaîne doivent être échappés : \n, \". Les chemins Windows demandent des antislashs doublés : "C:\\Users\\fichier.txt".
7. Les valeurs invalides
undefined, NaN, Infinity et les dates comme new Date() n'existent pas en JSON. Utilisez null, un nombre ou une chaîne ISO ("2026-07-09T10:00:00Z").
Lire un message d'erreur
« Unexpected token » signifie que l'analyseur a trouvé un caractère qu'il n'attendait pas à cet endroit. Regardez la position indiquée — et le caractère juste avant : c'est souvent là qu'est le vrai problème (virgule manquante, guillemet non fermé).
Pour aller plus loin
- Convertir du JSON en YAML (Kubernetes, GitHub Actions, Docker Compose) avec le convertisseur JSON ↔ YAML.
- Transformer un tableau JSON en tableur avec le convertisseur JSON ↔ CSV.
- Générer des types TypeScript à partir d'une réponse d'API avec JSON vers TypeScript.
- Inspecter un JWT, dont le contenu est du JSON encodé en Base64URL, avec le décodeur JWT.
Conclusion
Un formateur JSON fait partie de ces petits outils qu'on utilise dix fois par jour sans y penser. Formatez pour lire, validez avant de committer, minifiez pour la production — et quand l'analyseur se plaint, l'erreur est presque toujours l'une des sept ci-dessus.
Partager cet article
Articles similaires
Regex pour débutants : apprendre les expressions régulières en 10 exemples
Les expressions régulières ont l'air cryptiques, mais une douzaine de symboles couvrent 90 % des usages. Apprenez les bases des regex avec des exemples concrets — emails, téléphones, dates — et testez-les en direct.
Le JWT expliqué : comment fonctionnent les JSON Web Tokens (avec exemples)
Ce que contient un JWT, comment fonctionne la signature, ce que signifient les claims exp, iat et sub, et les erreurs de sécurité à éviter — avec un exemple décodé.
Transformer du code en belle image (pour vos slides, docs et réseaux sociaux)
Partagez du code sur LinkedIn, X ou dans une présentation sous forme d'image nette et colorée plutôt qu'en capture floue. Thèmes, fonds, conseils de lisibilité — et pourquoi toujours fournir aussi la version texte.