JSON Diff (Confronta)

Cos'è 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 }]

Funzionalità principali

Esempi

{"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}]}

Come si usa

1. 1

   Incolla entrambi i documenti JSON

   Incolla il JSON originale (sinistra) e modificato (destra). Il diff live viene visualizzato mentre scrivi; input grandi (>200 KB) passano a un pulsante Diff manuale.

2. 2

   Filtra il rumore

   Clicca un preset (Timestamps / IDs / Trace) o incolla pattern Extended JSON Pointer in Ignora percorsi per escludere i campi irrilevanti.

3. 3

   Scegli la vista di cui hai bisogno

   Affiancata per la revisione umana, JSON Patch (RFC 6902) per operazioni applicabili dalla macchina. Usa Share Link per inviare la configurazione a un collega.

Errori comuni nel 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

Casi d'uso comuni

Regressione risposta API

Confronta le risposte di staging e produzione; ignora timestamp e ID delle richieste per evidenziare solo le modifiche significative al payload.

Errori nei test snapshot CI

Incolla il reale vs il previsto da uno snapshot Jest/Vitest fallito. Filtra il rumore e trova la vera modifica in pochi secondi.

Conflitti package-lock / yarn.lock

Risolvi i conflitti di merge allineando le dipendenze per nome; l'ordine delle key e i campi non correlati smettono di essere rumore.

Audit valori K8s / Helm

Abbina env, volumeMounts e port per nome. Rileva ordinamenti non intenzionali vs modifiche reali alla configurazione.

Copertura traduzione i18n

Confronta strutturalmente en.json con zh.json per trovare key di traduzione mancanti o in eccesso senza rumore sui valori.

Revisione piano Terraform / CDK

Confronta l'output del piano tra esecuzioni; la tolleranza numerica gestisce l'aritmetica floating-point, ignora percorsi esclude ARN e timestamp.

Dettagli tecnici

Output patch conforme RFC 6902

Genera operazioni JSON Patch valide (add/remove/replace) con percorsi RFC 6901. Verificato rispetto ai pacchetti npm fast-json-patch@3.x e rfc6902.

Attraversamento iterativo

Attraversamento con stack esplicito (senza ricorsione) con limite di 100.000 nodi e profondità 64 per prevenire stack overflow su input avversariali.

Uguaglianza numerica Object.is

La tolleranza numerica predefinita è 0 — usa Object.is quindi -0 e +0 sono distinti. Imposta tolleranza > 0 per l'uguaglianza basata su epsilon.

Best Practice

Filtra prima di revisionare

Aggiungi prima Ignora percorsi (timestamp, ID, campi trace), poi leggi il diff. Revisionare diff rumorosi addestra l'occhio a saltare — e perdere — le modifiche reali.

Corrispondenza per key per insiemi logici

Se il tuo array rappresenta un insieme non ordinato (env, utenti, dipendenze), usa Corrispondenza per key. Il diff sequenziale su insiemi logici è quasi sempre sbagliato.

Condividi la configurazione, non gli input

Usa Share Link per inviare a un collega la configurazione del filtro — non incollare mai JSON sensibili in documenti condivisi. L'URL contiene solo la configurazione.

Domande frequenti