Aller au contenu principal
Guide

Le guide complet pour formater et valider JSON

· 6 min de lecture
#tutorial

JSON (JavaScript Object Notation) est devenu le standard de fait pour l’échange de données. Que vous déboguiez une API, parsiez un fichier de configuration ou transmettiez des données, JSON est partout.

Mais le JSON brut est presque illisible. C’est pourquoi les outils de formatage sont indispensables.

Pourquoi JSON est difficile à lire à l’œil nu

Les API renvoient généralement du JSON minifié :

{"name":"BoxrTools","tools":[{"slug":"json-formatter","category":"developer"},{"slug":"regex-tester","category":"developer"}],"stats":{"version":1,"free":true}}

Techniquement valide, mais il faut compter les accolades pour trouver un champ.

Une fois formaté :

{
  "name": "BoxrTools",
  "tools": [
    { "slug": "json-formatter", "category": "developer" },
    { "slug": "regex-tester", "category": "developer" }
  ],
  "stats": { "version": 1, "free": true }
}

Mêmes données, structure lisible au premier coup d’œil.

5 erreurs JSON courantes

1. Virgule finale

{ "a": 1, "b": 2, }  // ❌ erreur de syntaxe

JSON n’autorise pas la virgule finale.

2. Guillemets simples

{ 'a': 1 }  // ❌

Seuls les guillemets doubles sont acceptés.

3. Clés sans guillemets

{ a: 1 }  // ❌
{ "a": 1 }  // ✅

4. undefined à la sérialisation

JSON.stringify({ a: undefined })  // → '{}'

undefined n’existe pas en JSON.

5. Références circulaires

const a = {}; a.self = a;
JSON.stringify(a);  // ❌ lève une erreur

JSON ne peut pas représenter de structure circulaire.

Quelle indentation choisir

  • 2 espaces — compact, idéal pour les données imbriquées
  • 4 espaces — plus lisible
  • Tab — préférence personnelle

Il n’y a pas de bonne réponse. L’important est la cohérence.

Valider ≠ formater

Valider pose la question : « Est-ce du JSON valide ? ». Formater embellit.

Les bons outils font les deux.

Essayez notre outil

Notre formateur et validateur JSON offre :

  • Validation en temps réel + messages d’erreur avec numéro de ligne
  • 3 options d’indentation
  • Tri alphabétique des clés (optionnel)
  • Minification en un clic
  • 100 % dans le navigateur — vos données ne quittent jamais votre appareil
Retour au blog