Formatage JSON

Qu'est-ce qu'un formateur JSON ?

JSON (JavaScript Object Notation) est le format de données le plus utilisé sur le web. Les API le renvoient, les fichiers de configuration l'utilisent, les bases de données le stockent. La spécification JSON garde tout minimal, ce qui est idéal pour les machines mais pas pour lire les données. Un formateur JSON ajoute l'indentation et les sauts de ligne au JSON brut ou minifié pour voir clairement la structure.

Cet outil s'exécute entièrement dans votre navigateur. Votre JSON passe par JSON.stringify() avec une indentation de 2 espaces, et le résultat s'affiche dans le panneau de sortie. Rien n'est envoyé à un serveur, donc vous pouvez l'utiliser en toute sécurité avec des données de production, des tokens ou tout ce que vous ne voulez pas quitter votre machine.

Exemples de formatage JSON

Voici quelques exemples de ce que fait le formateur. Le JSON minifié ou compact est difficile à lire ; le formater révèle la structure en un coup d'œil.

Cliquez sur le bouton Exemple ci-dessus pour charger un exemple prêt à l'emploi (données de forfait mobile) dans l'éditeur et voir le formateur en action.

Comment utiliser cet outil

Comment fonctionne le formateur

Les deux éditeurs utilisent l'Ace Editor, qui fournit la coloration syntaxique, les numéros de ligne et les marqueurs d'erreur spécifiques au JSON. Lorsque vous collez ou tapez du JSON dans le panneau d'entrée, l'outil attend 300 ms (pour éviter le parsing en cours de frappe), puis exécute JSON.parse() sur votre entrée. Si le parsing réussit, il appelle JSON.stringify(data, null, 2) et affiche le résultat. Si le parsing échoue, la sortie affiche une erreur.

À noter : JSON ne prend pas en charge les commentaires. C'est défini dans la spécification elle-même, pas une limitation de cet outil. Des fichiers comme settings.json de VS Code utilisent JSONC (JSON avec commentaires), un format différent. Si votre fichier contient des commentaires, vous devrez les supprimer avant le formatage.

Où le formatage JSON aide

La plupart des développeurs ont besoin d'un formateur pour lire les réponses d'API. Vous envoyez une requête via Postman ou curl, et la réponse arrive sur une seule ligne compressée. La coller ici rend les objets et tableaux imbriqués visibles immédiatement. Pour extraire des valeurs spécifiques de grandes réponses, jq fonctionne bien en ligne de commande.

Les fichiers de configuration sont un autre cas courant. Un <code>package.json</code> ou <code>tsconfig.json</code> avec une indentation incohérente est difficile à réviser dans une pull request. Le formater ici vous donne une version cohérente à coller. Pour fusionner deux fichiers de configuration, il existe l'outil Fusion JSON.

Les exportations de bases de données depuis <a href="https://www.mongodb.com/docs/manual/reference/mongodb-extended-json/" target="_blank" rel="noopener">MongoDB</a>, Firestore ou CouchDB sont généralement de gros blocs JSON non formatés. Les passer ici aide à comprendre la structure du document avant d'écrire des scripts d'importation ou des requêtes. Si vous avez besoin des données dans une feuille de calcul, utilisez JSON vers CSV.

C'est aussi utile avant de partager du JSON avec l'équipe. Le JSON formaté dans un message Slack ou un ticket Jira est beaucoup plus lisible qu'une chaîne minifiée. Le passer d'abord par le Validateur JSON peut détecter les problèmes avant que d'autres ne les voient.

Questions fréquentes

Outils connexes

Pour en savoir plus sur JSON : guide MDN, RFC 8259, json.org et jq.