JSON lisible ou compact, que choisir
Publié le · Mis à jour le 3 min de lecture
Un fichier JSON est une façon d’écrire des données sous forme de texte : une liste de parcelles, les réglages d’une application, la réponse d’un site à un autre. Le même contenu peut s’écrire de deux manières, lisible ou compact, et le choix dépend de ce que vous voulez en faire.
La forme lisible
Dans la forme lisible, chaque information est sur sa ligne et décalée de quelques espaces selon sa place, ce qu’on appelle l’indentation. On comprend d’un coup d’œil ce qui est dans quoi. C’est la forme à utiliser quand vous relisez un fichier, que vous le comparez à une autre version ou que vous cherchez une erreur. Deux ou quatre espaces de décalage donnent le même résultat à l’œil. Quatre espaces rendent le fichier un peu plus aéré, mais aussi plus lourd, puisque chaque espace compte.
La forme compacte
Dans la forme compacte, dite minifiée, tout est écrit à la suite, sans retour à la ligne ni espace inutile. Le contenu est exactement le même, mais il devient difficile à lire pour une personne. Cette forme sert quand le fichier circule : envoyé à un site, stocké en grand nombre, ou chargé par une page web qui doit s’afficher vite. Sur une liste d’une quarantaine d’éléments, passer de quatre à deux espaces retire environ un cinquième du poids, et minifier en retire près de deux cinquièmes par rapport à la version à deux espaces. Ce qui disparaît, ce sont seulement des espaces et des retours à la ligne.
Comment choisir
Gardez la forme lisible pour tout ce que vous éditez à la main ou que vous partagez avec quelqu’un qui doit le comprendre. Passez à la forme compacte au dernier moment, juste avant l’envoi ou la mise en ligne. Conservez toujours la version lisible : on peut revenir de la forme compacte à la forme lisible à tout moment, mais seulement si l’on a gardé le fichier.
Quand utiliser chaque forme
Un développeur qui relit une réponse de serveur, un responsable de site qui vérifie un fichier de réglages ou une personne qui prépare des données pour un tableur ont intérêt à la forme lisible. Un site qui envoie ses données aux visiteurs, ou une application qui stocke des milliers d’enregistrements, gagne en rapidité avec la forme compacte.
Vérifier le résultat
Un JSON minifié doit se relire exactement comme l’original. Ouvrez-le avec le formateur : si le fichier s’affiche correctement, aucune donnée n’a été perdue. S’il s’affiche avec une erreur, c’est que le texte de départ n’était pas du JSON valide, et il faut le corriger avant de continuer.
Pour réduire le poids d’un fichier, voyez Minifier du JSON.
Questions fréquentes
- Minifier un JSON change-t-il les données ?
- Non. Seuls les espaces et les retours à la ligne disparaissent. Le contenu, l’ordre et les valeurs restent identiques.
- Combien de poids gagne-t-on en minifiant ?
- Sur une liste d’une quarantaine d’éléments, passer de quatre à deux espaces retire environ un cinquième du poids, et minifier en retire près de deux cinquièmes par rapport à deux espaces. Le gain dépend du nombre de lignes et de la profondeur du fichier.
- Peut-on revenir à la forme lisible après avoir minifié ?
- Oui, en ouvrant le fichier avec le formateur. Il remet l’indentation, mais pas les anciens commentaires ni la mise en forme manuelle, d’où l’intérêt de garder la version lisible.
- Que faire si le formateur affiche une erreur ?
- Le texte de départ n’est pas du JSON valide : une virgule en trop, un guillemet manquant ou une apostrophe à la place d’un guillemet sont les causes les plus fréquentes.