Comparer deux documents JSON

Comparer deux documents JSON: usages et conseils pratiques

La comparaison structurelle JSON sépare les changements de données des changements de présentation. Les documents avec des indentations différentes ou des membres d'objets ordonnés différemment peuvent représenter exactement les mêmes valeurs. L'outil analyse les deux documents et compare leur contenu. Lorsque rien ne diffère, le rapport est un tableau vide et le compteur affiche zéro. Cela ne signifie pas que les fichiers originaux sont identiques octet pour octet : les espaces, les terminaisons de ligne ou la notation numérique peuvent différer tout en produisant la même valeur interprétée. Utilisez une comparaison en texte brut lorsque ces détails de représentation font l'objet de la révision.

Les tableaux sont comparés par position. Le remplacement de deux éléments peut produire plusieurs changements même lorsque les deux éléments sont toujours présents. Les objets ne sont pas automatiquement mis en correspondance avec des champs tels que id, et l'outil ne calcule pas une séquence minimale d'éditions de liste. Pour comparer des ensembles non ordonnés, préparez d'abord une représentation triée par une clé explicite appropriée à vos données. Types importent aussi: 1 diffère de "1", false n'est pas équivalent à 0, et un membre manquant diffère d'un membre présent avec null. Le remplacement d'un objet entier par une chaîne est signalé comme un changement de valeur à ce chemin plutôt que comme des changements à chaque ancien enfant.

Chaque différence contient chemin et changement. Les membres ajoutés incluent after, les membres supprimés incluent before et les valeurs modifiées incluent les deux. Les chemins utilisent le texte JSON Pointer syntaxe : les barres obliques et les tildes dans les noms de membres sont échappés ~1 et ~0. Un chemin vide indique la racine lorsque le document entier change de type ou de valeur. Le rapport est descriptif et n'utilise pas le format JSON Patch ; ne l'exécutez pas comme une séquence d'instructions pour mettre à jour un autre document. Conservez les deux originaux afin de pouvoir répéter la comparaison et inspecter le contexte entourant chaque différence rapportée avant de faire une modification ailleurs.

L'analyse rejette les clés en double et les entiers dont la magnitude ne peut pas être représentée en toute sécurité. JSON utilise la précision numérique du navigateur; les systèmes d'origine doivent utiliser des chaînes pour les identifiants longs, tandis que les calculs décimaux exacts nécessitent un système approprié spécifique au domaine. Chaque document prend en charge jusqu'à un million de caractères et cent niveaux d'imbrication. Si plus d'un millier de différences se produisent, l'opération demande des sections plus petites plutôt que de présenter un rapport incomplet qui semble complet. Avant d'examiner une longue réponse, essayez un nom modifié, un membre supprimé et un tableau réorganisé pour comprendre comment ces cas apparaissent dans la sortie et quels détails restent pertinents pour votre comparaison.