Aller au contenu principal
Développeur9 juillet 20264 min de lecture

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.

#json#formateur json#validateur json#api#outils développeur
Formater et valider du JSON (et corriger les 7 erreurs les plus courantes)

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érationCe qu'elle faitQuand l'utiliser
Formater (indenter)Ajoute indentation et retours à la ligneLire une réponse d'API, déboguer
ValiderVérifie la syntaxe et localise les erreursAvant de committer une config, après une édition à la main
MinifierSupprime tous les espaces inutilesProduction, 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.

Formater du JSON

Formatez et validez votre JSON instantanément.

Essayer gratuitement
  • 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

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

Prêt à utiliser nos outils dev ?

Gratuit, rapide et sans inscription.

Essayer maintenant

Articles similaires