Comparer les données plutôt que leur présentation
Collez le JSON initial à gauche et la version modifiée à droite. L'outil analyse les deux documents et compare leurs structures de données. Les espaces, l'indentation et l'ordre des clés d'un objet ne créent pas de fausses différences, car ils relèvent de la présentation. Un changement de valeur, une clé ajoutée ou supprimée apparaît en revanche. Cette méthode est utile lorsque deux réponses d'API semblent différentes à l'écran et que vous voulez savoir si leurs données ont réellement évolué. Les textes restent dans le navigateur pendant la comparaison.
Les tableaux JSON sont des listes ordonnées. Leurs éléments sont comparés suivant leur position. Déplacer une valeur peut donc entraîner plusieurs différences : c'est voulu lorsqu'un tableau représente des étapes ou un classement. Si chaque élément possède un identifiant stable et que l'ordre n'a pas d'importance, alignez ou triez d'abord les enregistrements selon une règle adaptée à votre domaine. N'attribuez pas automatiquement chaque décalage à une modification distincte.
Comprendre le chemin de chaque différence
Chaque écart porte un chemin semblable à JSON Pointer. Une clé nom à la racine correspond à /nom ; le deuxième élément du tableau rôles correspond à /rôles/1. Le résultat distingue les valeurs ajoutées, retirées et modifiées. Les caractères spéciaux dans les clés sont échappés : une barre oblique devient ~1 et un tilde devient ~0. Le chemin permet ainsi de retrouver précisément un changement dans un document imbriqué sans parcourir tout le texte.
Essayez l'exemple intégré. L'objet de départ contient nom égal à Ada et le rôle administratrice ; la nouvelle version emploie Grace et ajoute le rôle éditrice. La sortie devrait indiquer une modification de /nom et un ajout à /rôles/1. Une simple nouvelle indentation ne donne aucune différence structurelle. Remplacer la chaîne "1" par le nombre 1 produit en revanche une modification réelle : ces deux valeurs appartiennent à des types JSON distincts.
Utilisation avec une API ou une configuration
Comparez la réponse d'un service avant et après un déploiement, deux versions d'un fichier de configuration ou la sortie attendue d'un test avec la sortie effective. Reportez les chemins concernés dans un ticket afin qu'un collègue reproduise le constat. Le traitement local évite d'envoyer les documents à un service externe, mais partager ensuite une capture ou des valeurs confidentielles reste un choix séparé qui mérite attention.
Commencez par valider les deux textes. Corrigez les virgules finales et commentaires, interdits par le JSON standard. Lancez la comparaison, lisez le premier chemin différent et demandez-vous si la modification a un sens dans votre application. Si de nombreux indices de tableau semblent décalés, vérifiez si un simple changement d'ordre explique la série avant de conclure que chaque élément a été retouché.
Limites et portée du résultat
La comparaison est structurelle : elle ne valide pas un schéma et ne connaît pas la logique de votre application. Elle ne sait pas si deux URL différentes mènent à la même ressource ou si un champ renommé l'a été volontairement. Les très grandes entrées sont limitées et l'affichage s'arrête aux 500 premiers écarts pour préserver la réactivité. Conservez les originaux si une analyse complète d'un énorme document est nécessaire.
L'analyse JSON ordinaire réduit les noms de clés dupliqués selon le comportement du parseur. Cette page ne convient donc pas pour étudier un document ambigu contenant plusieurs fois le même nom. Les valeurs numériques suivent aussi la représentation de JavaScript ; les entiers au-delà de sa plage sûre exigent un analyseur exact. L'outil vise surtout les charges d'API et configurations courantes qui respectent ces limites.