JSON Diff (Porównaj)

Czym jest 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 }]

Główne funkcje

Przykłady

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

Jak używać

1. 1

   Wklej oba dokumenty JSON

   Wklej oryginalny (lewy) i zmodyfikowany (prawy) JSON. Diff renderuje się na żywo podczas pisania; duże dane wejściowe (>200 KB) przełączają się na ręczny przycisk Diff.

2. 2

   Odfiltruj szum

   Kliknij preset (Timestamps / IDs / Trace) lub wklej rozszerzone wzorce JSON Pointer do pola Ignoruj ścieżki, aby pominąć nieistotne pola.

3. 3

   Wybierz potrzebny widok

   Widok obok siebie do przeglądu przez człowieka, JSON Patch (RFC 6902) do operacji stosowalnych maszynowo. Użyj Share Link, aby wysłać konfigurację do kolegi.

Typowe pułapki 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

Typowe przypadki użycia

Regresja odpowiedzi API

Porównaj odpowiedzi staging vs produkcja; ignoruj znaczniki czasu i ID żądań, aby ujawnić tylko istotne zmiany ładunku.

Awarie testów migawkowych w CI

Wklej rzeczywiste i oczekiwane dane z nieudanego snapshotu Jest/Vitest. Odfiltruj szum i znajdź prawdziwą zmianę w kilka sekund.

Konflikty package-lock / yarn.lock

Rozwiązuj konflikty scalania przez wyrównanie zależności po nazwie; kolejność kluczy i niepowiązane pola przestają być szumem.

Audyt wartości K8s / Helm

Dopasuj envs, volumeMounts i porty po nazwie. Wychwytuj niezamierzone zmiany kolejności vs rzeczywiste edycje konfiguracji.

Pokrycie tłumaczeń i18n

Porównaj strukturalnie en.json z zh.json, aby znaleźć brakujące lub nadmiarowe klucze tłumaczeń bez szumu wartości.

Przegląd planów Terraform / CDK

Porównaj wyjście planów między uruchomieniami; tolerancja numeryczna obsługuje arytmetykę zmiennoprzecinkową, ścieżki ignorowane usuwają ARN i znaczniki czasu.

Szczegóły techniczne

Zgodny z RFC 6902 wynik patch

Generuje prawidłowe operacje JSON Patch (add/remove/replace) ze ścieżkami RFC 6901. Zweryfikowany względem fast-json-patch@3.x i pakietu npm rfc6902.

Iteracyjne przechodzenie drzewa

Przechodzenie ze stosu jawnego (bez rekurencji) ograniczone do 100 000 węzłów i głębokości 64, aby zapobiec przepełnieniu stosu na złośliwych danych wejściowych.

Równość numeryczna Object.is

Domyślna tolerancja numeryczna to 0 — używa Object.is, więc -0 i +0 są rozróżniane. Ustaw tolerancję > 0 dla równości opartej na epsilon.

Najlepsze praktyki

Filtruj przed przeglądaniem

Najpierw dodaj ścieżki ignorowane (znaczniki czasu, ID, pola trace), a następnie czytaj diff. Przeglądanie szumliwych diffów uczy oko, aby pomijało — i przez to przegapiało — prawdziwe zmiany.

Dopasuj po kluczu dla logicznych zbiorów

Jeśli Twoja tablica reprezentuje nieuporządkowany zbiór (envs, użytkownicy, zależności), użyj Dopasowania po kluczu. Sekwencyjny diff na logicznych zbiorach jest prawie zawsze błędny.

Udostępniaj konfigurację, nie dane wejściowe

Użyj Share Link, aby wysłać koledze konfigurację filtrów — nigdy nie wklejaj wrażliwego JSON do współdzielonych dokumentów. URL zawiera tylko konfigurację.

Często zadawane pytania