Comment formater du JSON : Le guide complet pour développeurs

JSON (JavaScript Object Notation) est le langage universel de l'échange de données sur le web. Que vous construisiez une API REST, configuriez une application ou transfériez des données entre services, vous travaillerez régulièrement avec du JSON. Mais le JSON brut peut être difficile à lire, et même de petites erreurs de syntaxe peuvent casser toute votre application.

Ce guide couvre tout ce que vous devez savoir sur le formatage JSON — de la structure de base aux astuces avancées en passant par les pièges courants.

Qu'est-ce que le JSON ?

JSON est un format de données léger, textuel, facile à lire pour les humains et à analyser pour les machines. Il repose sur deux structures :

• Paires clé-valeur (objets) : { "nom": "Alice", "age": 30 }
• Listes ordonnées (tableaux) : [1, 2, 3, "quatre"]

Celles-ci peuvent être imbriquées pour créer des structures complexes :

{
  "utilisateur": {
    "nom": "Alice",
    "roles": ["admin", "editeur"],
    "parametres": {
      "theme": "sombre",
      "notifications": true
    }
  }
}

Pourquoi formater le JSON ?

Quand le JSON est minifié (tout espace supprimé), il devient presque impossible à lire :

{"utilisateur":{"nom":"Alice","roles":["admin","editeur"],"parametres":{"theme":"sombre","notifications":true}}}

Le formatage (aussi appelé « embelli » ou « pretty-print ») ajoute de l'indentation et des sauts de ligne pour rendre la structure visible :

{
  "utilisateur": {
    "nom": "Alice",
    "roles": [
      "admin",
      "editeur"
    ],
    "parametres": {
      "theme": "sombre",
      "notifications": true
    }
  }
}

Le JSON formaté est essentiel pour :

• Déboguer les réponses API : Repérer rapidement les champs manquants ou les valeurs inattendues.
• Revue de code : Rendre les fichiers de configuration lisibles pour votre équipe.
• Documentation : Inclure des exemples JSON clairs dans vos docs.
• Édition manuelle : Trouver et corriger les erreurs sans perdre la tête.

Bonnes pratiques de formatage JSON

1. Utilisez une indentation cohérente

Le standard est de 2 espaces ou 4 espaces par niveau. Choisissez-en un et respectez-le dans tout votre projet. La plupart des guides de style (y compris ceux de Google et Airbnb) recommandent 2 espaces.

2. Mettez toujours les clés entre guillemets doubles

Le JSON exige des guillemets doubles autour de toutes les clés d'objet. C'est une erreur fréquente quand on vient de JavaScript :

// ❌ JSON invalide
{ nom: "Alice" }

// ✅ JSON valide
{ "nom": "Alice" }

3. Utilisez des guillemets doubles pour les chaînes

Les chaînes JSON doivent utiliser des guillemets doubles, pas des guillemets simples :

// ❌ Invalide
{ 'nom': 'Alice' }

// ✅ Valide
{ "nom": "Alice" }

4. Pas de virgules finales

Contrairement à JavaScript, le JSON n'autorise pas les virgules finales :

// ❌ Invalide
{ "nom": "Alice", "age": 30, }

// ✅ Valide
{ "nom": "Alice", "age": 30 }

5. Types de données valides uniquement

Le JSON prend en charge exactement six types de données :

Type	Exemple
String	"bonjour"
Number	42, 3.14
Boolean	true, false
Null	null
Object	{ "cle": "valeur" }
Array	[1, 2, 3]

Il n'y a pas de undefined, Date, function ni Symbol en JSON.

Comment formater du JSON programmatiquement

JavaScript

const data = { nom: "Alice", age: 30 };
const formate = JSON.stringify(data, null, 2);
console.log(formate);

Le troisième paramètre (2) définit l'indentation à 2 espaces.

Python

import json
data = {"nom": "Alice", "age": 30}
formate = json.dumps(data, indent=2, ensure_ascii=False)
print(formate)

Ligne de commande (jq)

echo '{"nom":"Alice"}' | jq .

Erreurs JSON courantes et comment les corriger

Erreur	Cause	Solution
Unexpected token '	Guillemets simples au lieu de doubles	Remplacer ' par "
Unexpected end of JSON input	Données tronquées ou vides	Vérifier que le JSON est complet
Unexpected token ,	Virgule finale	Supprimer la dernière virgule
Unexpected token u	undefined dans les données	Remplacer par null ou supprimer la clé

Validez avant de formater

Le formatage ne corrige pas le JSON invalide. Si votre JSON contient des erreurs de syntaxe, un formateur peut produire des résultats inattendus ou échouer. Validez toujours votre JSON d'abord, puis formatez-le.

Un bon formateur validera et embellira votre JSON en une seule étape, en signalant les erreurs avec des numéros de ligne et des descriptions claires.

Essayez notre formateur JSON gratuit

Notre Formateur JSON s'occupe de tout pour vous. Collez votre JSON, et il va :

• Détecter et corriger automatiquement les problèmes de formatage courants
• Embellir votre JSON avec une indentation configurable
• Valider la syntaxe et mettre en évidence les erreurs
• Fonctionner entièrement dans votre navigateur — vos données ne quittent jamais votre appareil

Que vous déboguiez une réponse API délicate, nettoyiez un fichier de configuration ou prépariez du JSON pour de la documentation, notre formateur rend l'opération instantanée et sans erreur.

JSON vs XML vs YAML

Si vous hésitez sur le format de données pour votre projet, voici une comparaison rapide :

Critère	JSON	XML	YAML
Lisibilité	Bonne	Verbeux	Excellente
Taille	Petite	Grande	Moyenne
Vitesse d'analyse	Rapide	Lent	Moyen
Types de données	Limités	Aucun (tout en chaînes)	Riche
Commentaires	Non supportés	Supportés	Supportés

Le JSON reste le meilleur choix pour les API et l'échange de données web grâce à son équilibre entre simplicité, rapidité et support universel.

Conclusion

Un JSON correctement formaté fait gagner du temps, réduit les bugs et rend votre code plus maintenable. Suivez les bonnes pratiques ci-dessus, validez avant de formater, et utilisez les bons outils pour accélérer votre flux de travail.

Essayez le Formateur JSON maintenant — collez votre JSON et voyez la différence que le formatage fait en quelques secondes.