Comment comparer deux fichiers JSON (et pourquoi un diff de texte vous induit en erreur)
Comparez deux fichiers JSON et voyez quelles clés ont été ajoutées, supprimées ou modifiées. Pourquoi le diff de texte fait du bruit, et comment les tableaux sont appariés.
Mis à jour le 7 novembre 20269 min de lecture
Pour comparer deux fichiers JSON, ouvrez le comparateur Diff JSON, déposez un fichier de chaque côté (ou collez le texte) et lisez la liste des différences. Chacune est marquée comme ajoutée, supprimée, modifiée ou de type modifié, avec le chemin exact de la valeur. L'outil compare les données, pas le texte : des clés réordonnées ou une indentation différente n'apparaissent donc pas comme des changements. C'est toute la raison de l'utiliser plutôt qu'un diff de texte classique.
Pourquoi un diff de texte sur du JSON fait tant de bruit
Une comparaison de texte travaille ligne par ligne. Le JSON, lui, ne se soucie pas des lignes. Ces deux documents contiennent exactement les mêmes données, et pourtant un diff de texte marque toutes les lignes comme différentes : l'un est écrit sur une seule ligne, l'autre est indenté de quatre espaces, et les clés arrivent dans un ordre différent.
| Ce qui diffère | Le diff de texte dit | Les données disent |
|---|---|---|
| Indentation (2 espaces, 4 ou une tabulation) | Toutes les lignes ont changé | Rien n'a changé |
| Fichier entier minifié sur une ligne | Une ligne remplacée par une autre | Rien n'a changé |
| Clés dans un ordre différent | Lignes déplacées ou réécrites | Rien n'a changé : les objets n'ont pas d'ordre |
| 1 écrit 1.0 | Ligne modifiée | Le même nombre |
| Un prix qui passe de 9,99 à 10,99 | Une ligne modifiée | Une valeur modifiée |
La dernière ligne est celle qui vous intéresse, et dans un diff de texte elle est noyée sous les quatre premières. De nombreuses API renvoient les clés dans un ordre différent à chaque appel, et de nombreux outils réécrivent l'indentation à l'enregistrement : le bruit est donc le cas normal, pas l'exception.
Comparer deux fichiers JSON, étape par étape
Ajoutez le document de gauche
Ouvrez le comparateur Diff JSON. Collez l'original dans la zone Gauche (original) ou déposez un fichier .json sur la zone de dépôt. L'outil ouvre aussi les fichiers .jsonc, .geojson, .map et .txt.
Ajoutez le document de droite
Collez ou déposez la version modifiée dans Droite (modifié). Si vous déposez les deux fichiers en même temps, ils sont appariés par nom : billing.before.json et billing.after.json se retrouvent donc du bon côté. Utilisez Inverser les côtés s'ils sont à l'envers.
Lisez les différences
La comparaison s'exécute à la frappe. Choisissez Côte à côte, En ligne ou Par chemin. Le résumé indique combien de valeurs ont été ajoutées, supprimées et modifiées, et les boutons Changement suivant et Précédent sautent de l'une à l'autre. Le filtre permet de n'afficher que les ajouts, les suppressions, les modifications ou les changements de type.
Réglez ce qui compte comme une différence
Ouvrez les paramètres de comparaison pour ignorer l'ordre des tableaux, la casse ou les espaces, fixer une tolérance numérique ou écarter les clés qui changent toujours. Les sections suivantes détaillent chaque option.
Exportez si vous voulez garder une trace
Copier le résumé place une liste simple des changements dans le presse-papiers. Télécharger le correctif JSON donne un fichier standard qui transforme le document de gauche en celui de droite. Télécharger le Markdown donne un rapport à coller dans un ticket ou une pull request.
Comparez deux documents et voyez chaque valeur ajoutée, supprimée et modifiée, par chemin. Gratuit : une paire à la fois, jusqu'à 10 Mo par côté, avec toutes les options et tous les exports. Tout s'exécute sur votre appareil, pas sur nos serveurs.
Comparer deux fichiers JSONCe que dit le rapport : ajouté, supprimé, modifié
L'outil parcourt les deux documents ensemble et signale chaque différence avec son emplacement. Les objets sont comparés clé par clé, à n'importe quelle profondeur. Une clé qui n'existe qu'à droite est ajoutée. Une clé qui n'existe qu'à gauche est supprimée. Une clé présente des deux côtés avec une valeur différente est modifiée. Une valeur dont la nature a changé, comme le texte "3" qui devient le nombre 3, est signalée à part comme type modifié, car c'est le changement le plus susceptible de casser ce qui lira le fichier ensuite.
Les emplacements sont écrits sous forme de chemins. Dans Par chemin, vous voyez où se situe chaque changement, par exemple le nom du deuxième élément d'une liste d'utilisateurs. Le correctif exporté utilise la forme standard JSON Pointer (/users/1/name), qui reste sans ambiguïté même lorsqu'une clé contient un point ou une barre oblique.
- Les nombres sont comparés par valeur : 1, 1.0 et 1e0 sont le même nombre et ne sont pas signalés.
- Réordonner les clés d'un objet n'est jamais un changement.
- Le niveau supérieur peut être tout ce que JSON autorise : un objet, un tableau, ou même une simple chaîne ou un nombre.
- Si un document déclare deux fois la même clé, l'outil vous avertit, car les analyseurs ne gardent silencieusement que la dernière valeur et une différence dans la première est invisible.
Comment les tableaux sont comparés
C'est avec les tableaux que les comparaisons de JSON se trompent. Si deux listes sont comparées strictement position par position, ajouter un élément au début fait paraître tous les suivants différents. L'outil évite cela en alignant d'abord les éléments, et il indique à côté du résumé la stratégie utilisée.
| Stratégie | Quand elle est utilisée | Utile pour |
|---|---|---|
| Par id | Vous indiquez un champ dans Apparier les éléments par champ et chaque élément y a une valeur unique | Des enregistrements d'une API revenus dans un autre ordre |
| Par plus longue sous-séquence commune | C'est le réglage par défaut | Des listes où des éléments ont été insérés ou retirés |
| Comme un ensemble | Ignorer l'ordre des tableaux est activé | Étiquettes, permissions, tout ce dont l'ordre n'a pas de sens |
| Par position | Les deux listes n'ont presque rien en commun | Des listes réellement remplacées |
L'appariement par id est celui à privilégier pour les listes d'enregistrements. Saisissez le nom du champ (id est le plus courant) et une liste réordonnée est présentée comme réordonnée, avec seulement l'enregistrement qui a réellement changé. L'outil n'utilise le champ que si chaque élément le possède et qu'aucune valeur ne se répète. Sinon, il produirait un appariement propre mais faux : il revient donc au réglage par défaut plutôt que de deviner.
Ignorer le bruit : clés, chemins, casse et nombres
La comparaison stricte est le réglage par défaut : chaque valeur, chaque type et chaque position dans un tableau doivent correspondre. Chaque paramètre assouplit exactement une chose, et le rapport exporté indique lesquels étaient activés.
- Clés à ignorer : indiquez des noms comme updatedAt ou requestId, séparés par des virgules. Elles sont écartées partout où elles apparaissent, à n'importe quelle profondeur. C'est ce qui transforme deux instantanés d'API en un diff lisible.
- Chemins à ignorer : écartez un emplacement précis, avec * pour un niveau et ** pour un nombre quelconque. /users/*/lastSeen écarte ce champ pour tous les utilisateurs.
- Ignorer la casse et Ignorer les espaces : pour des libellés dont le style a changé, ou des descriptions dont les retours à la ligne ont été refaits.
- Tolérance numérique : l'écart maximal pour que deux nombres comptent comme égaux. Avec une tolérance de 0,0001, le bruit d'arrondi des décimaux disparaît, tandis qu'un vrai changement de prix reste visible.
- Autoriser commentaires et virgules finales : pour les fichiers de configuration écrits en JSONC.
Usages courants : évolution d'une API et dérive de configuration
Pour une API qui a changé, enregistrez la réponse avant et après, ajoutez les champs qui changent toujours (horodatages, identifiants de requête, etags) aux clés ignorées, et ce qui reste est le vrai changement de structure. Pour la dérive de configuration entre deux environnements, comme la préproduction et la production, chargez les deux fichiers et regardez Par chemin : la liste montre exactement quels réglages diffèrent, et rien d'autre. Pour une migration ou un export, comparez l'ancien et le nouveau fichier et téléchargez le rapport Markdown comme trace de ce qui a bougé.
Si vous préférez rester sur un diff de texte ordinaire, par exemple dans un outil de revue de code, rendez d'abord les deux fichiers identiques en apparence : passez chacun dans le formateur JSON avec la même indentation, et mettez les clés dans un seul ordre avec trier les clés JSON. Trier les clés ne déplace que les clés, les valeurs ne sont pas touchées. Cela supprime l'essentiel du bruit de texte, mais ne fait pas ce que fait le comparateur avec les tableaux, les tolérances ou les champs ignorés.
Limites et ce qui peut mal tourner
- Taille : Gratuit compare une paire à la fois, jusqu'à 10 Mo par côté. Pro relève la taille à ce que supporte votre appareil et compare jusqu'à 50 paires à la fois, appariées par nom de fichier, avec tous les rapports et correctifs dans un ZIP. Un fichier au-dessus de la limite gratuite est refusé avec sa taille réelle et un lien vers le minificateur, car du JSON mis en forme est souvent surtout de l'indentation.
- Autres formats : les fichiers YAML, XML, CSV et Excel sont refusés dès l'entrée avec un lien vers le bon convertisseur, comme YAML vers JSON. Convertissez d'abord, comparez ensuite.
- « Aucune différence » paraît faux : vérifiez si un réglage d'exclusion, une tolérance numérique élevée ou un avertissement de clé en double l'explique.
- Trop de différences : au-delà de 100 000, la liste cesse de s'allonger, mais les totaux restent exacts, et la page indique que la liste a été tronquée.
- Une très grande liste dans deux ordres différents : indiquez un champ id ou activez Ignorer l'ordre des tableaux, plutôt que de lire des milliers de déplacements.
La comparaison s'exécute sur votre appareil, pas sur nos serveurs : les identifiants et les données clients d'une réponse ne sont donc pas envoyés pour être comparés. Pour un aperçu des différences entre JSON et d'autres formats de données, voyez JSON, CSV et XML.
Questions fréquentes
Comment comparer deux fichiers JSON en ligne ?
Ouvrez le comparateur Diff JSON, déposez un fichier de chaque côté ou collez le texte, et lisez la liste des valeurs ajoutées, supprimées et modifiées. La comparaison se fait à la frappe. La version gratuite couvre une paire jusqu'à 10 Mo par côté.
L'ordre des clés a-t-il une importance ?
Non. Les objets n'ont pas d'ordre : un objet réordonné est comparé comme identique. Seuls les tableaux ont un ordre, et vous pouvez activer Ignorer l'ordre des tableaux si cela n'a pas d'importance non plus.
Comment comparer deux tableaux JSON dont les éléments ont changé de place ?
Saisissez le nom d'un champ unique, en général id, dans Apparier les éléments par champ. Les éléments s'alignent alors sur cette valeur plutôt que sur leur position, et une liste réordonnée n'affiche que les enregistrements réellement modifiés. Ou activez Ignorer l'ordre des tableaux.
Puis-je ignorer des champs comme les horodatages ?
Oui. Indiquez les noms de clés dans Clés à ignorer, par exemple updatedAt, requestId. Elles sont écartées à toute profondeur. Pour n'écarter qu'un seul emplacement, utilisez Chemins à ignorer, qui accepte les jokers * et **.
Puis-je comparer du JSON avec des commentaires, comme un fichier de configuration ?
Oui. Activez Autoriser commentaires et virgules finales, ou déposez un fichier .jsonc, ce qui l'active pour vous. Le YAML et le XML ne s'ouvrent pas directement : convertissez-les d'abord en JSON.
Puis-je enregistrer les différences ?
Oui, de trois façons, toutes dans l'offre gratuite : copier un résumé simple, télécharger un correctif JSON RFC 6902, ou télécharger un rapport Markdown. Pro ajoute des lots de jusqu'à 50 paires dans un ZIP.