Guide de l’outil
À propos de Comparateur JSON
Un outil de comparaison JSON confronte deux documents par leur structure et non par leur texte, ce qui vous montre ce qui a changé dans les données plutôt que dans la mise en forme.
Collez le JSON d'origine d'un côté et le JSON modifié de l'autre : la comparaison se met à jour immédiatement sous forme de tableau des valeurs ajoutées, supprimées et modifiées, avec le chemin de chacune.
Comment utiliser l'outil JSON Diff
- Collez le document d'origine dans le premier champ et le document modifié dans le second.
- Lisez les compteurs de synthèse en haut, affichés sous la forme +N -N ~N, pour évaluer l'ampleur du changement.
- Parcourez le tableau de résultats : type de changement, chemin, valeur avant, valeur après.
- Remontez un chemin tel que a.b[2] jusque dans votre fichier source : les clés se joignent par des points et les tableaux utilisent un index.
Dans quels cas s'en servir
- Comparer la configuration de deux environnements, par exemple un fichier JSON de préproduction face à celui de production.
- Examiner l'évolution d'une réponse d'API entre deux versions d'un service avant de vous appuyer sur la nouvelle forme.
- Chercher ce qui a réellement bougé à l'intérieur d'un package-lock.json ou d'un autre manifeste de dépendances généré.
- Vérifier ce qu'un outil a modifié après avoir resérialisé un fichier d'infrastructure as code ou un manifeste Kubernetes.
Comment les chemins et les types de changement sont rapportés
Chaque ligne désigne un emplacement précis du document, écrit comme vous liriez la valeur dans du code, pour la retrouver facilement dans le fichier source.
- Ajouté : le chemin n'existe que dans le document modifié, et la colonne valeur après indique la nouvelle valeur.
- Supprimé : le chemin n'existe que dans l'original, et la colonne valeur avant montre ce qui s'y trouvait.
- Modifié : le chemin existe des deux côtés avec des valeurs différentes, donc les deux colonnes sont renseignées.
- Un chemin comme a.b[2] signifie la clé b dans l'objet a, puis l'élément d'index 2 de ce tableau.
Questions fréquentes sur Comparaison JSON
- Pourquoi reformater le fichier ne produit-il aucune différence ?
- Parce que les deux côtés sont d'abord analysés. L'indentation, l'ordre des clés et les fins de ligne ne font pas partie de la structure analysée : ils n'apparaissent donc jamais comme des différences.
- Pourquoi l'insertion d'un seul élément de tableau marque-t-elle comme modifié tout ce qui suit ?
- Les tableaux sont comparés par index. Une insertion décale tous les éléments suivants vers une nouvelle position, et chaque position décalée est signalée comme un changement. C'est inhérent à la comparaison positionnelle, ce n'est pas un défaut.
- Que se passe-t-il si l'un des côtés n'est pas du JSON valide ?
- Les deux entrées doivent être analysées avec succès. Si l'un des côtés est mal formé, une erreur d'analyse s'affiche à la place de la comparaison.
- Qu'affiche l'outil quand les deux documents sont identiques ?
- Il indique explicitement qu'il n'y a aucune différence structurelle, au lieu de laisser un résultat vide qui pourrait passer pour un échec.
- Mes données sont-elles envoyées quelque part ?
- Non. L'analyse et la comparaison s'exécutent localement dans votre navigateur grâce à la bibliothèque microdiff : rien de ce que vous collez n'est transmis à wetool.site ni à un autre serveur.
Comparaison JSON et comparaison de texte brut
Une comparaison de texte confronte des lignes de caractères : des clés réordonnées, un passage de deux à quatre espaces ou des fins de ligne différentes ressortent comme des différences alors même que les données sont identiques, et les vraies modifications se noient dans ce bruit. Une comparaison JSON analyse d'abord les deux documents et ne rapporte que les différences sémantiques, en ignorant l'ordre des clés et la mise en forme. Utilisez une comparaison de texte quand les octets exacts comptent, et celle-ci quand seules les données comptent.
Lire les résultats sans se faire piéger
La comparaison structurelle répond avec précision à une question étroite : il est donc utile de savoir ce que le tableau dit et ce qu'il ne dit pas.
- Une longue liste de changements concentrés dans un même tableau traduit le plus souvent une insertion unique ou un réordonnancement, plutôt que de nombreuses modifications indépendantes.
- Les types comptent : la chaîne 1 et le nombre 1 sont des valeurs distinctes et sont signalés comme un changement.