JSON Diff Vergleich

Was ist 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 }]

Hauptfunktionen

Beispiele

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

Anleitung

1. 1

   Beide JSON-Dokumente einfügen

   Das originale (links) und das geänderte (rechts) JSON einfügen. Der Live-Diff wird während der Eingabe gerendert; bei großen Eingaben (>200 KB) wechselt er zu einem manuellen Diff-Button.

2. 2

   Rauschen herausfiltern

   Auf ein Preset klicken (Timestamps / IDs / Trace) oder Extended JSON Pointer-Muster in 'Ignore-Pfade' einfügen, um irrelevante Felder auszublenden.

3. 3

   Gewünschte Ansicht wählen

   Nebeneinander für die menschliche Überprüfung, JSON Patch (RFC 6902) für maschinell anwendbare Ops. 'Link teilen' verwenden, um die Konfiguration an ein Teammitglied zu senden.

Häufige Diff-Fallstricke

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

Anwendungsfälle

API-Antwort Regression

Staging- vs. Produktions-Antworten vergleichen; Zeitstempel und Request-IDs ignorieren, um nur bedeutsame Payload-Änderungen sichtbar zu machen.

CI Snapshot-Test-Fehler

Tatsächliche vs. erwartete Werte aus einem fehlgeschlagenen Jest/Vitest-Snapshot einfügen. Rauschen herausfiltern und die echte Änderung in Sekunden finden.

package-lock / yarn.lock Konflikte

Merge-Konflikte auflösen, indem Abhängigkeiten am Namen ausgerichtet werden; Schlüsselreihenfolge und irrelevante Felder werden kein Rauschen mehr.

K8s / Helm Values-Audit

Envs, volumeMounts und Ports am Namen ausrichten. Unbeabsichtigte Reihenfolgeänderungen von echten Konfigurationsänderungen unterscheiden.

i18n Übersetzungsabdeckung

en.json und zh.json strukturell vergleichen, um fehlende oder überzählige Übersetzungsschlüssel zu finden – ohne Werte-Rauschen.

Terraform / CDK Plan-Review

Plan-Ausgaben zwischen Läufen vergleichen; numerische Toleranz behandelt Gleitkomma-Arithmetik, Ignore-Pfade blenden ARNs und Zeitstempel aus.

Technische Details

RFC 6902-konforme Patch-Ausgabe

Erzeugt gültige JSON Patch-Ops (add/remove/replace) mit RFC 6901-Pfaden. Validiert gegen fast-json-patch@3.x und rfc6902 npm-Pakete.

Iterative Traversierung

Explizite Stack-Traversierung (keine Rekursion) begrenzt auf 100.000 Knoten und Tiefe 64, um Stack-Overflow bei ungünstigen Eingaben zu verhindern.

Object.is numerische Gleichheit

Standard-Toleranz ist 0 – verwendet Object.is, sodass -0 und +0 unterschieden werden. Toleranz > 0 für Epsilon-basierte Gleichheit setzen.

Best Practices

Zuerst filtern, dann prüfen

Ignore-Pfade zuerst hinzufügen (Zeitstempel, IDs, Trace-Felder), dann den Diff lesen. Verrauschte Diffs zu überprüfen trainiert das Auge, echte Änderungen zu übersehen.

Abgleich per Schlüssel für logische Mengen

Wenn ein Array eine ungeordnete Menge darstellt (Envs, Benutzer, Abhängigkeiten), 'Abgleich per Schlüssel' verwenden. Sequenzieller Diff auf logischen Mengen ist fast immer falsch.

Konfiguration teilen, nicht Eingaben

'Link teilen' nutzen, um einem Kollegen die Filterkonfiguration zu senden – niemals sensibles JSON in geteilte Dokumente einfügen. Die URL enthält nur die Konfiguration.

Häufig gestellte Fragen