abox.tools

Langue: Français

Comment comparer deux fichiers JSON

Comparez deux fichiers JSON tels quels et presque tout ce qui s'allume n'est rien : indentation, retours à la ligne, clés dans un autre ordre. Le remède n'est pas un diff plus malin — c'est de passer les deux fichiers par le même formateur d'abord, pour qu'il ne reste que les vraies différences. Les deux étapes tournent dans votre navigateur, qui est là où doivent rester des fichiers de configuration avec des secrets dedans.

Ouvrir Comparateur de textes Deux textes en entrée, chaque différence marquée, ligne à ligne et mot à mot. Rien n'est collé dans le serveur de quelqu'un d'autre.

Voir en Markdown

La réponse courte

  1. Ouvrez le Formateur JSON, collez le premier fichier, réglez l'indentation sur deux espaces et cochez Trier les clés de chaque objet. Copiez le résultat.
  2. Ouvrez le Comparateur de textes et collez-le dans la zone de gauche.
  3. Faites de même avec le second fichier, dans la zone de droite.

Le résultat est bien plus facile à lire : une valeur modifiée, une clé apparue, une entrée supprimée. Les différences de mise en forme et les clés réordonnées qui auraient noyé un diff ordinaire disparaissent, car les deux côtés ont été écrits de la même façon avant la comparaison.

Aucune des deux pages n'a la moindre fonction réseau — bon à savoir, puisque le JSON que l'on compare est si souvent un fichier de configuration avec ses identifiants encore dedans.

Modifications de configuration et régressions d'API

Pour comparer préproduction et production, gardez les originaux et formatez une copie de chacun avec deux espaces et les clés d'objet triées. Placez la préproduction à gauche et la production à droite, désactivez Ignorer la casse et Ignorer les espaces, puis examinez les points d'accès, indicateurs de fonctionnalités et limites. Les espaces dans une chaîne et la casse d'une clé peuvent compter. Téléchargez le patch après avoir confirmé quel environnement est de quel côté.

La même recette vérifie une réponse d'API avant et après une modification. Utilisez les mêmes entrées de requête et traitez séparément les horodatages ou identifiants générés. Les tableaux gardent leur ordre : une liste réordonnée reste différente, comme il convient à une séquence JSON ordonnée. Des nombres équivalents comme 1 et 1.0, ou des chaînes échappées différemment, peuvent aussi différer ici. C'est une comparaison de texte formaté, pas une validation de schéma ni un test d'équivalence de toutes les valeurs JSON. La norme JSON distingue les objets non ordonnés des tableaux ordonnés.

Pourquoi un diff JSON brut n'est presque que du bruit

JSON se moque des espaces, et il ne donne aucun sens à l'ordre des clés. Le même document peut tenir en une ligne ou en quatre cents, les clés dans l'ordre où on les a tapées ou dans celui qu'une bibliothèque a émis — et les outils réécrivent tout cela librement. Un côté minifié, l'autre déplié ; un côté enregistré à la main, l'autre par un sérialiseur qui trie par ordre alphabétique : un diff de lignes voit deux fichiers étrangers.

Les deux pires cas suffisent à la démonstration. Un fichier minifié est une ligne, donc un diff contre lui est une seule ligne changée, gigantesque — vrai et inutile. Et deux fichiers au même contenu dans un autre ordre se comparent comme tout-a-changé, quand la réponse honnête serait « rien ».

Les options de comparaison : un affichage côte à côte ou en ligne, un interrupteur pour n'afficher que les lignes modifiées, et des interrupteurs pour ignorer les espaces, la casse et les lignes vides.
Utilisez les options d'ignorance avec prudence : elles affectent l'affichage, tandis que le patch téléchargé conserve toutes les différences d'entrée, y compris les fins de ligne.

Ce que la forme canonique du formateur répare

Passer les deux fichiers par le même formateur avec les mêmes réglages est exactement ce qu'il faut à un diff : une écriture par document.

Une réserve honnête : la sortie triée est le document avec ses clés déplacées. Si un outil en aval tient à l'ordre des clés — peu le font, mais il en existe — traitez les copies triées comme la chose comparée, pas comme un remplacement des originaux.

Lire le résultat, et l'emporter

Le comparateur marque les lignes retirées à gauche, les ajoutées à droite, et surligne dans une ligne changée les mots qui diffèrent — sur une forme canonique, c'est typiquement la seule valeur passée de false à true. Le milieu inchangé se replie en un compte, si bien qu'une configuration de deux mille lignes avec trois retouches se lit comme trois courts passages.

Le téléchargement est un correctif unifié, un .patch — le format que la revue de code comprend. Il décrit les formes canoniques, ce qui est en général ce qu'une revue veut de toute façon : le changement, sans le reformatage.

Formater puis comparer peut aussi faciliter l'examen du YAML ou du XML, mais leurs règles d'espacement et de conversion diffèrent de celles du JSON. Gardez le langage d'origine si seule la présentation doit changer. Les options d'ignorance du diff affectent sa vue ; le patch compare les chaînes réellement fournies. Ici, ce sont vos copies formatées : ce patch ne s'applique donc pas aux originaux intacts.

Deux versions d'une configuration JSON côte à côte, les lignes modifiées signalées : un numéro de version, un nombre de tentatives, une option ajoutée et une région ajoutée.
Quatre différences réelles, et rien d'autre signalé. Les lire est la moitié facile ; le travail a été fait par les réglages du dessus.

Si vous faites cela chaque semaine

Formater deux fois, coller deux fois — les étapes vivent sur deux pages parce que chaque page fait un travail, et que chacune peut prouver seule que rien de ce que vous avez collé n'est allé nulle part. Mais les deux sont libres : licence MIT, des modules ES sans dépendances — le parseur du formateur garde l'ordre des clés et les chiffres, le diff est l'algorithme de Myers — chacun avec un README qui l'explique.

Si cela fait partie de vos journées, pointez un agent de code vers le dépôt et demandez-lui une page à deux zones qui canonise en comparant — parseJson, printJson et compareText sont à trois imports de là. Les modules ont été écrits pour être lus, et les emporter est exactement ce à quoi sert la licence.