Une comparaison qui lit le JSON, pas seulement le texte
Deux fichiers JSON peuvent contenir exactement les mêmes données tout en étant écrits différemment : clés dans un autre ordre, autre indentation, nombres écrits 1.0 au lieu de 1. Une comparaison ligne à ligne signale alors des dizaines d'écarts qui n'en sont pas. Cet outil lit les deux documents et les parcourt clé par clé : il ne signale que ce qui a vraiment changé, avec le chemin exact, par exemple $.users[2].email.
Usages courants : vérifier qu'une réponse d'API n'a pas bougé après une mise à jour, comparer la configuration de préproduction et celle de production, contrôler un export avant de l'importer.
Mode d'emploi
- Collez le premier document dans « JSON A (original) » et le second dans « JSON B (modifié) », ou utilisez « Ouvrir un fichier ». Chaque zone est validée : en cas d'erreur, le message donne la ligne, la colonne et la cause, et « Aller à l'erreur » place le curseur dessus.
- La comparaison se lance seule. Les compteurs donnent le nombre d'ajouts, de suppressions, de modifications et de changements de type.
- Choisissez l'affichage : « Liste des différences », « Côte à côte » (arborescence A et B alignée) ou « JSON Patch ».
- Réglez les options si besoin, puis cliquez sur « Copier le rapport », « Rapport .txt » ou « JSON Patch .json ».
« Formater A et B » et « Trier les clés » remettent les deux textes en forme avec une indentation de 2 espaces. « Échanger A et B » inverse le sens de la comparaison.
Exemple et symboles
Avec A = {"a":1,"b":[1,2],"c":{"d":"x"}} et B = {"a":2,"b":[2,1],"c":{"d":"x","e":true}}, l'outil trouve 4 différences :
| Symbole | Chemin | Détail |
|---|---|---|
| ~ | $.a | 1 → 2 |
| − | $.b[0] | 1 supprimé |
| + | $.b[1] | 1 ajouté |
| + | $.c.e | true ajouté |
Le tableau [1,2] devenu [2,1] est lu comme un 1 déplacé en fin de liste. Si l'ordre ne compte pas pour vous, cochez « Ignorer l'ordre des éléments des tableaux » : il ne reste que 2 différences, $.a et $.c.e. Les symboles +, − et ~ restent lisibles sans les couleurs, à l'écran comme dans le rapport texte.
Associer les éléments par identifiant
Pour une liste d'objets réordonnée, choisissez « par clé d'identifiant » et indiquez id. Avec A = [{"id":1,"v":"x"},{"id":2,"v":"y"}] et B = [{"id":2,"v":"y2"},{"id":1,"v":"x2"}], l'outil trouve 2 modifications ($[0].v : "y" → "y2" et $[1].v : "x" → "x2") au lieu de 4 en associant les objets par leur position.
Le JSON Patch
Le JSON Patch est un format normalisé qui décrit les changements sous forme d'opérations : add, remove et replace, chacune avec un chemin de type /c/e. Pour l'exemple ci-dessus, les 4 opérations appliquées à A dans l'ordre redonnent B. Un programme peut ainsi envoyer seulement les changements au lieu du document entier.
Autres options
« Ignorer la casse des chaînes » rend "Paris" égal à "PARIS". La « Tolérance numérique » considère 1 et 1,004 comme égaux avec 0,01. « Chemins ignorés » écarte des valeurs qui changent à chaque appel, comme $.meta.updatedAt ou $.users[*].lastLogin. Un fichier de plusieurs mégaoctets est comparé en arrière-plan sans figer la page.
Questions fréquentes
Quelle différence avec une comparaison de textes ?
Une comparaison de textes compare des lignes. Ici, seules les données comptent : l'ordre des clés, les espaces et les retours à la ligne n'ont aucun effet, et chaque écart est donné avec son chemin.
Qu'est-ce qu'un changement de type ?
Une valeur qui change de nature, par exemple le nombre 8080 devenu la chaîne "8080". Cet écart casse souvent un programme.
Mes JSON sont-ils envoyés quelque part ?
Non. Tout est calculé dans votre navigateur. Seules vos options sont retenues pour la prochaine visite, jamais le contenu des zones.
Le JSON Patch tient-il compte des options ?
Oui : il ne contient que les différences affichées. Sans option, il transforme A en B à l'identique. Si l'ordre des tableaux est ignoré, les nouveaux éléments sont ajoutés en fin de tableau.