JSON Diff (Comparateur)

Qu'est-ce que JSON Diff ?

// Two JSON documents that look different but are semantically equal
const a = '{"a":1,"b":2}';
const b = '{"b":2,"a":1}';

// Naive comparison — wrong
JSON.stringify(JSON.parse(a)) === JSON.stringify(JSON.parse(b));
// → false (key order differs)

// JSON Diff (this tool) — correct: key order is irrelevant
// → 0 differences

// JSON Patch (RFC 6902) for { "a": 1 } → { "a": 2 }
// [{ "op": "replace", "path": "/a", "value": 2 }]

Fonctionnalités clés

Exemples

{"user":{"id":1,"name":"Ada","createdAt":"2024-01-01"}}

{"user":{"id":1,"name":"Ada Lovelace","createdAt":"2024-02-02"}}

{"a":1,"b":2,"c":3}

{"c":3,"a":1,"b":2}

[{"id":1,"qty":3},{"id":2,"qty":5}]

[{"id":2,"qty":5},{"id":1,"qty":4}]

{"items":[{"id":1,"price":29.99}]}

{"items":[{"id":1,"price":24.99}]}

Comment utiliser

1. 1

   Collez les deux documents JSON

   Collez le JSON original (gauche) et modifié (droite). Le diff live s'affiche pendant la saisie ; les grandes entrées (>200 Ko) basculent vers un bouton Diff manuel.

2. 2

   Filtrez le bruit

   Cliquez sur un préréglage (Timestamps / IDs / Trace) ou collez des patterns JSON Pointer étendus dans « Ignorer les chemins » pour exclure les champs non pertinents.

3. 3

   Choisissez la vue dont vous avez besoin

   Côte à côte pour la révision humaine, JSON Patch (RFC 6902) pour les opérations applicables par machine. Utilisez Lien de partage pour envoyer la configuration à un collègue.

Pièges courants du diff

diff a.json b.json   # text diff: 'everything changed'

JSON Diff (this tool): 0 differences

{"a": null} == {}   # collapsed by some tools

{"a": null} ≠ {}     # type-strict diff

Sequential diff: 4 modified

Match by key (id): 0 differences

{"id": 42} vs {"id": "42"}   # serialization bug

Diff reports 'modified (type)' with both values

tolerance=0:  0.30000000000000004 ≠ 0.3

tolerance=1e-9: equal

Diff: 47 modifications (45 are timestamps)

Add /createdAt, /updatedAt, /requestId to Ignore paths → 2 real changes

Cas d'usage courants

Régression de réponse API

Comparez les réponses staging et production ; ignorez les horodatages et les ID de requête pour ne faire ressortir que les changements de payload significatifs.

Échecs de tests snapshot CI

Collez le réel vs l'attendu d'un snapshot Jest/Vitest en échec. Filtrez le bruit et trouvez le vrai changement en quelques secondes.

Conflits package-lock / yarn.lock

Résolvez les conflits de fusion en alignant les dépendances sur le nom ; l'ordre des clés et les champs non liés cessent d'être du bruit.

Audit des valeurs K8s / Helm

Faites correspondre envs, volumeMounts et ports par nom. Détectez les réordonnances non intentionnelles vs les vraies modifications de config.

Couverture de traduction i18n

Comparez structurellement en.json avec zh.json pour trouver les clés de traduction manquantes ou supplémentaires sans bruit de valeur.

Révision du plan Terraform / CDK

Comparez la sortie du plan entre les exécutions ; la tolérance numérique gère l'arithmétique en virgule flottante, les chemins ignorés suppriment les ARN et les horodatages.

Détails techniques

Sortie de patch conforme RFC 6902

Génère des opérations JSON Patch valides (add/remove/replace) avec des chemins RFC 6901. Vérifié contre fast-json-patch@3.x et les packages npm rfc6902.

Traversée itérative

Traversée à pile explicite (sans récursion) limitée à 100 000 nœuds et une profondeur de 64 pour prévenir le débordement de pile sur des entrées adverses.

Égalité numérique Object.is

La tolérance numérique par défaut est 0 — utilise Object.is donc -0 et +0 sont distingués. Définissez la tolérance > 0 pour l'égalité basée sur epsilon.

Bonnes pratiques

Filtrez avant de réviser

Ajoutez d'abord les chemins à ignorer (horodatages, ID, champs de trace), puis lisez le diff. Réviser des diffs bruyants entraîne l'œil à sauter — et à manquer — les vrais changements.

Correspondance par clé pour les ensembles logiques

Si votre tableau représente un ensemble non ordonné (envs, utilisateurs, dépendances), utilisez Correspondance par clé. Le diff séquentiel sur les ensembles logiques est presque toujours incorrect.

Partagez le lien, pas les entrées

Utilisez Lien de partage pour envoyer à un collègue votre configuration de filtre — ne collez jamais de JSON sensible dans des documents partagés. L'URL ne contient que la configuration.

Foire aux questions