JSON (JavaScript Object Notation) is a lightweight data format used to exchange data between servers and web applications. It uses key-value pairs and arrays, and is readable by both humans and machines.

Raw JSON from APIs is often minified (no whitespace) to save bandwidth. Formatting adds indentation and line breaks, making it much easier to read, debug, and understand the data structure.

Is my data sent to a server?

No. All formatting and validation happens entirely in your browser using JavaScript. Your JSON data never leaves your device.

What does the depth stat mean?

Depth refers to the maximum nesting level of your JSON. A flat object like {"a": 1} has depth 1. An object containing another object has depth 2, and so on.

Formateur JSON — Ligne/colonne d'erreur

Comment fonctionne le formateur JSON

Collez n'importe quelle chaîne JSON dans la zone de saisie et cliquez sur Formater. Choisissez entre 2 espaces, 4 espaces ou une tabulation. L'outil valide votre JSON d'abord — s'il contient des erreurs de syntaxe, vous verrez le message d'erreur exact avec la position.

Cliquez sur Minifier pour supprimer tous les espaces blancs pour un stockage ou une transmission compact. Le panneau de statistiques montre le nombre total de clés, la profondeur d'imbrication maximale et la taille en octets.

Qu'est-ce que le JSON et pourquoi est-ce important ?

JSON (JavaScript Object Notation) est le format universel d'échange de données pour les API web. Créé par Douglas Crockford au début des années 2000, il a remplacé XML comme format dominant grâce à sa simplicité et sa lisibilité. Sa syntaxe est basée sur un sous-ensemble de JavaScript, ce qui le rend immédiatement familier aux développeurs web, mais il est entièrement indépendant du langage — tous les principaux langages de programmation peuvent analyser et générer du JSON nativement. Le format représente les données sous forme de paires clé-valeur (objets) et de listes ordonnées (tableaux), qui correspondent naturellement aux structures de données utilisées dans pratiquement toutes les applications.

Chaque API moderne — des services météo aux réseaux sociaux, des passerelles de paiement aux services de cartographie — envoie et reçoit du JSON. Comprendre la structure JSON est essentiel pour les développeurs web, les analystes de données, les ingénieurs QA et toute personne travaillant avec des API ou des scripts d'automatisation. Lorsqu'on récupère des données d'une API REST, configure un webhook, écrit un pipeline CI/CD ou inspecte une requête réseau dans le navigateur, le JSON est presque certainement ce qu'on regarde. Un formateur est le premier outil qu'on utilise pour rendre lisibles les réponses d'API brutes et minifiées.

Erreurs JSON courantes et comment les corriger

Virgules finales — JSON n'autorise pas de virgule après le dernier élément d'un objet ou d'un tableau, contrairement à JavaScript. {"a": 1, "b": 2,} est un JSON invalide même si c'est un JS valide. C'est l'une des erreurs les plus fréquentes lors de l'édition manuelle de JSON copié depuis du code source JavaScript. Supprimez la virgule finale et la validation passera.
Guillemets simples — JSON exige des guillemets doubles pour toutes les chaînes et tous les noms de clés. {'nom': 'Alice'} est invalide ; ce doit être {"nom": "Alice"}. Cela piège les développeurs qui travaillent principalement en Python ou JavaScript, où les guillemets simples sont parfaitement valides. Un remplacement des guillemets simples par des doubles corrige généralement le problème.
Guillemets manquants sur les clés — En JavaScript, les clés d'objet peuvent être sans guillemets ({nom: "Alice"}), mais en JSON chaque clé doit être une chaîne entre guillemets ({"nom": "Alice"}). C'est particulièrement courant lors de la conversion de littéraux d'objets JavaScript en JSON. Entourez toujours les noms de clés de guillemets doubles.
Caractères spéciaux non échappés dans les chaînes — Certains caractères à l'intérieur des valeurs de chaîne JSON doivent être échappés avec une barre oblique inverse : guillemet double (\"), barre oblique inverse (\\), saut de ligne (\n), tabulation (\t). Le formateur vous indiquera la position exacte du caractère problématique.
Commentaires — JSON ne prend pas en charge les commentaires. Ni // commentaires de ligne ni /* commentaires de bloc */ ne sont valides. Si vous avez besoin de commentaires dans un fichier de configuration, utilisez JSONC (JSON avec commentaires, pris en charge par VS Code et de nombreux outils), ou supprimez les commentaires avant l'analyse. Cela surprend de nombreux développeurs lors de la copie d'exemples de configuration qui incluent des commentaires explicatifs.

Pour ceux qui cherchent une virgule mal placée dans 800 lignes de réponse API

Les messages d'erreur de syntaxe indiquent maintenant la ligne et la colonne exactes — et non le décalage brut « position N » de V8, qui n'a aucun sens sans compter les caractères à la main. Collez un payload cassé, et vous verrez « ligne 47, colonne 12 » au lieu de « position 1843 ». C'est la différence entre trouver le bug en cinq secondes et faire défiler pendant deux minutes. La position est extraite directement de l'erreur native JSON.parse, donc elle est précise à l'octet.

Vous pouvez aussi télécharger le résultat formaté sous forme de fichier .json horodaté — pratique pour transmettre un payload nettoyé à un collègue ou archiver un instantané de réponse API. Le nom du fichier inclut la date et l'heure pour éviter de vous retrouver avec cinq fichiers « output.json ». Pas d'envoi : le fichier est généré dans le navigateur et enregistré directement dans votre dossier de téléchargements.

Règles de syntaxe JSON et erreurs courantes

Les clés doivent être des chaînes entre guillemets doubles — {"name": "Alice"} ✓ — {name: "Alice"} ✗ (c'est un littéral d'objet JavaScript, pas du JSON).
Pas de virgules finales — [1, 2, 3,] est du JSON invalide. Le dernier élément ne doit pas avoir de virgule. Cela piège les développeurs qui copient depuis du code JavaScript.
Pas de commentaires — JSON ne prend pas en charge les commentaires // ligne ni /* bloc */. Utilisez JSON5 ou JSONC si vous avez besoin de commentaires (ex. : dans les paramètres VS Code).
Les chaînes doivent utiliser des guillemets doubles — les chaînes entre guillemets simples ('Alice') ne sont pas du JSON valide.
Nombres, pas de zéros en tête (01 est invalide), pas de notation hexadécimale (0xFF invalide), et Infinity / NaN ne sont pas des valeurs JSON valides.
Null, true, false — uniquement en minuscules (null, true, false, pas NULL, True, False).

Outils connexes : Décodeur JWT, Encodeur URL, Encodeur Base64, et Testeur de regex.

JSON minifié vs formaté : quand utiliser l'un ou l'autre

Minifié (compact) — supprime tous les espaces. Taille réduite = transfert HTTP plus rapide. À utiliser dans les réponses API en production, les fichiers de configuration envoyés sur le réseau, et les valeurs localStorage. Un JSON formaté de 1 Mo peut faire 600–700 Ko minifié.
Formaté/indenté — ajoute indentation et sauts de ligne pour la lisibilité humaine. À utiliser pour les fichiers de configuration versionnés, le débogage, la documentation et les logs.
Conventions d'indentation — 2 espaces (le plus courant en JavaScript/TypeScript et JSON Schema), 4 espaces (projets Python), tabulations (certains projets Go et PHP). JSON lui-même n'impose aucun style, c'est purement cosmétique.
Tri des clés — trier les clés JSON alphabétiquement facilite la lecture des diffs en contrôle de version. Les diffs Git de JSON trié sont plus faciles à relire — on repère immédiatement les champs ajoutés ou supprimés.
Sécurité — ne jamais logger ou stocker des payloads JSON complets provenant de sources non fiables sans assainissement. JSON peut contenir des injections affectant les consommateurs en aval.

Questions fréquentes

C'est quoi exactement le JSON ?

JSON (JavaScript Object Notation) est un format de données léger utilisé pour échanger des données entre serveurs et applications web. Il utilise des paires clé-valeur et des tableaux, et est lisible par les humains et les machines.

Pourquoi formater le JSON ?

Le JSON brut des API est souvent minifié (sans espaces) pour économiser la bande passante. Le formatage ajoute une indentation et des sauts de ligne, ce qui facilite grandement la lecture, le débogage et la compréhension de la structure des données.

Mes données sont-elles envoyées à un serveur ?

Non. Tout le formatage et la validation se font entièrement dans votre navigateur en JavaScript. Vos données JSON ne quittent jamais votre appareil.

Que signifie la statistique de profondeur ?

La profondeur désigne le niveau d'imbrication maximal de votre JSON. Un objet plat comme {"a": 1} a une profondeur de 1. Un objet contenant un autre objet a une profondeur de 2, etc. Un JSON très imbriqué (profondeur 5+) peut parfois indiquer une conception qui pourrait être simplifiée.

Quelle est la différence entre JSON et XML ?

JSON et XML sont tous deux des formats d'échange de données, mais JSON est généralement plus compact et plus facile à analyser. XML utilise des balises d'ouverture et de fermeture (verbeux), prend en charge les attributs et les espaces de noms, et était la norme pour les API web avant 2010. JSON utilise des paires clé-valeur, est nativement supporté par JavaScript, et est généralement 30 à 50 % plus petit que l'équivalent XML. Aujourd'hui, pratiquement toutes les nouvelles API utilisent JSON. XML reste courant dans les systèmes d'entreprise, les services SOAP et les formats de documents comme SVG et les fichiers Office.

Puis-je formater de très grands fichiers JSON ?

Oui, mais les outils basés sur navigateur ont des limites pratiques. Les fichiers jusqu'à quelques mégaoctets se formatent instantanément. Les très grands fichiers (10 Mo+) peuvent causer un court délai pendant que JavaScript les analyse de manière synchrone sur le thread principal. Pour les fichiers dépassant 50 Mo, un outil en ligne de commande comme jq est plus approprié : jq '.' grand-fichier.json produit du JSON formaté sans contraintes de mémoire du navigateur.

Pourquoi mon JSON est-il invalide ? Je l'ai copié depuis du JavaScript.

Les littéraux d'objets JavaScript ressemblent à du JSON mais présentent des différences clés : JS autorise les clés sans guillemets ({name: 'Alice'}), les chaînes entre guillemets simples, les virgules finales, les commentaires et les valeurs spéciales comme undefined et NaN — rien de tout cela n'est du JSON valide. Utilisez JSON.stringify(votreObjet) en JavaScript pour convertir un objet JS en JSON valide, ou collez-le dans ce formateur pour voir exactement quel caractère cause l'erreur d'analyse.

Quelle est la différence entre JSON et JSON5 ?

JSON5 est un sur-ensemble de JSON qui ajoute : les chaînes entre guillemets simples, les clés sans guillemets, les virgules finales, les commentaires (// et /* */), les chaînes multilignes et les nombres hexadécimaux. Il est couramment utilisé dans les fichiers de configuration (Babel, ESLint) où la commodité d'édition humaine prime sur l'interopérabilité stricte. Le JSON standard reste le bon choix pour les API, les bases de données et l'échange de données — JSON5 est réservé aux fichiers de configuration édités par des humains.