Ce que fait l'impression jolie à votre JSON
Le JSON minifié rassemble toutes les données sur une seule ligne pour économiser des octets — idéal pour la transmission réseau mais illisible pour les humains. L'impression jolie est l'inverse : elle resérialise la structure de données analysée avec des sauts de ligne et une indentation cohérents, de sorte que chaque paire clé-valeur et chaque élément de tableau apparaît sur sa propre ligne, imbriqué à la bonne profondeur.
Notre formateur analyse d'abord l'entrée — ce qui signifie qu'il détecte les erreurs de syntaxe avant de tenter le formatage — puis resérialise avec le style d'indentation choisi (2 espaces, 4 espaces ou une tabulation). Le résultat est déterministe : la même entrée produit toujours la même sortie formatée, quelle que soit l'espace blanche d'origine.
Au-delà de la lisibilité, l'impression jolie est une forme légère de normalisation. Les clés dans chaque objet restent dans leur ordre d'origine, mais tous les espaces superflus sont supprimés puis rajoutés uniformément. Cela rend les différences ligne par ligne entre deux fichiers JSON beaucoup plus propres.
Styles d'indentation et quand les utiliser
L'indentation de deux espaces est le style le plus courant dans les bases de code JavaScript et TypeScript et dans la plupart des exemples de JSON Schema. Elle empêche les structures profondément imbriquées de dériver trop loin à droite sur des terminaux de 80 caractères de large.
L'indentation de quatre espaces est le standard dans les communautés Python (PEP 8) et Java. Si votre JSON sera intégré dans un projet Python ou Java et examiné aux côtés d'autres fichiers, quatre espaces le rend visuellement cohérent.
L'indentation par tabulation permet à l'éditeur de chaque développeur d'afficher l'indentation à sa largeur préférée. Préférez les tabulations lorsque votre dépôt utilise déjà des tabulations pour d'autres types de fichiers, afin de garder le style cohérent.
Impression jolie vs. Formatage vs. Validation vs. Minification
L'impression jolie et le formatage sont la même opération : ajouter des espaces blancs pour la lisibilité. La validation vérifie si le JSON est syntaxiquement correct et, éventuellement, s'il correspond à un schéma — elle ne modifie pas les données. La minification est l'opposé de l'impression jolie : elle supprime tous les espaces blancs non significatifs pour réduire la taille du fichier.
Utilisez l'impression jolie quand vous recevez une réponse API, une entrée de journal ou un blob de configuration difficile à lire sous forme minifiée. Utilisez la minification avant d'intégrer du JSON dans une page HTML de production. Utilisez la validation pour confirmer que les données sont correctes avant de les traiter.
Pour les très grands fichiers JSON (des centaines de mégaoctets), les outils basés sur le navigateur peuvent être lents. Dans ces cas, utilisez des outils en ligne de commande : python -m json.tool ou jq . sur macOS/Linux.