JSON Diff (Vergelijken)

Wat is 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 }]

Belangrijkste Functies

Voorbeelden

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

Gebruiksaanwijzing

1. 1

   Plak beide JSON-documenten

   Plak de originele (links) en gewijzigde (rechts) JSON. Live diff wordt direct weergegeven terwijl je typt; grote invoer (>200 KB) schakelt over naar een handmatige Diff-knop.

2. 2

   Filter de ruis

   Klik op een preset (Tijdstempels / ID's / Trace) of plak Extended JSON Pointer-patronen in Negeer paden om irrelevante velden te verwijderen.

3. 3

   Kies de gewenste weergave

   Zij-aan-zij voor menselijke beoordeling, JSON Patch (RFC 6902) voor machine-toepasbare ops. Gebruik Deellink om de configuratie met een teamlid te delen.

Veelvoorkomende Diff-valkuilen

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

Veelvoorkomende Gebruikssituaties

API Response Regressie

Vergelijk staging- vs productieantwoorden; negeer tijdstempels en verzoek-ID's om alleen betekenisvolle payload-wijzigingen te zien.

CI Snapshot-testfouten

Plak actual vs expected uit een falende Jest/Vitest-snapshot. Filter ruis en vind de echte wijziging in seconden.

package-lock / yarn.lock Conflicten

Los merge-conflicten op door afhankelijkheden op naam uit te lijnen; sleutelvolgorde en niet-gerelateerde velden zijn geen ruis meer.

K8s / Helm Values Audit

Koppel envs, volumeMounts en ports op naam. Detecteer onbedoelde herordeningen versus echte configuratiewijzigingen.

i18n Vertaaldekking

Vergelijk en.json structureel met zh.json om ontbrekende of extra vertaalsleutels te vinden zonder waarde-ruis.

Terraform / CDK Plan Review

Vergelijk planuitvoer tussen runs; numerieke tolerantie verwerkt drijvende-komma-rekenkunde, negeer paden verwijderen ARN's en tijdstempels.

Technische Details

RFC 6902-conforme Patch-uitvoer

Genereert geldige JSON Patch-ops (add/remove/replace) met RFC 6901-paden. Gevalideerd tegen fast-json-patch@3.x en het npm-pakket rfc6902.

Iteratieve Doorloop

Expliciete-stack-doorloop (geen recursie) begrensd op 100.000 knooppunten en diepte 64 om stack overflow bij kwaadaardige invoer te voorkomen.

Object.is Numerieke Gelijkheid

Standaard numerieke tolerantie is 0 — gebruikt Object.is zodat -0 en +0 worden onderscheiden. Stel tolerantie > 0 in voor epsilon-gebaseerde gelijkheid.

Best Practices

Filter voor je beoordeelt

Voeg eerst Negeer paden toe (tijdstempels, ID's, tracevelden), lees dan de diff. Ruizige diffs bekijken traint het oog om over echte wijzigingen heen te kijken.

Koppelen op sleutel voor logische sets

Als je array een ongeordende set vertegenwoordigt (envs, gebruikers, afhankelijkheden), gebruik Koppelen op sleutel. Sequentiële diff op logische sets is bijna altijd onjuist.

Deel configuratie, niet invoer

Gebruik Deellink om een collega je filterconfiguratie te sturen — plak nooit gevoelige JSON in gedeelde documenten. De URL bevat alleen de configuratie.

Veelgestelde Vragen