JSON Diff — Porównywarka JSON

Do czego służy JSON Diff

JSON Diff porównuje dwie sparsowane wartości JSON i pokazuje, co zmieniło się w każdej ścieżce. Jest przydatny do sprawdzania zmian w odpowiedziach API, edycji konfiguracji, aktualizacji fixture’ów, payloadów flag funkcji, przykładów webhooków, plików tłumaczeń i wygenerowanych danych, gdy diff oparty na wierszach jest zbyt zaszumiony. Zamiast pokazywać zmiany interpunkcji, rekurencyjnie przechodzi przez obiekty i tablice i oznacza ścieżki jako dodane, usunięte, zmienione lub niezmienione. Ponieważ obie strony są najpierw parsowane jako ścisły JSON, błędy składni są wychwytywane przed porównaniem, co pomaga odróżnić nieprawidłowe dane wejściowe od rzeczywistych różnic strukturalnych.

Raport używa kolorowych wierszy, dzięki czemu istotne zmiany od razu rzucają się w oczy. Dodane wartości są zielone, usunięte ścieżki czerwone, zmienione wartości bursztynowe, a niezmienione ścieżki prymitywne wyświetlane są wyszarzonym tekstem. Raport w postaci zwykłego tekstu możesz skopiować do zgłoszenia, pull requesta, notatki z debugowania lub przeglądu testów, gdy trzeba wyjaśnić, czym różnią się dwa payloady.

Prywatny przepływ pracy w przeglądarce

Całe przetwarzanie odbywa się w Twojej przeglądarce za pomocą JavaScriptu po stronie klienta. Narzędzie nie wysyła na serwer fragmentów kodu, wartości konfiguracji, wygenerowanych danych, treści zapytań ani skopiowanych przykładów i nie wymaga konta. Taki wyłącznie lokalny model ma znaczenie w narzędziach dla programistów, ponieważ wklejana do nich zawartość często wygląda jak prawdziwe dane aplikacji: odpowiedzi API, logi, przykłady w stylu zmiennych środowiskowych, zapytania do bazy danych, znaczniki z wersji roboczych lub wartości skopiowane z sesji debugowania na produkcji. Lokalne przetwarzanie zmniejsza ryzyko i przyspiesza pracę, bo nie ma komunikacji przez sieć.

Interfejs jest celowo zwarty, aby można było wkleić dane, zmienić opcje, sprawdzić wynik, skopiować go i wrócić do edytora. Wyniki nadal warto sprawdzić, zanim trafią do commita, zostaną udostępnione publicznie lub użyte w procesie produkcyjnym. Narzędzia w przeglądarce świetnie nadają się do szybkiej inspekcji i przygotowania danych, ale nie znają każdej konwencji projektu, zasady klasyfikacji danych ani wymagań walidacyjnych specyficznych dla aplikacji.

Praktyczne wskazówki

Używaj tego narzędzia do małych i średnich fragmentów JSON, które chcesz szybko zrozumieć. Bardzo duże dokumenty może być łatwiej porównywać w dedykowanym edytorze, zwłaszcza gdy tablice zawierają elementy w zmienionej kolejności lub rekordy bez stałych identyfikatorów. Ten diff w przeglądarce porównuje pozycje w tablicach bezpośrednio, więc element wstawiony na początku może sprawić, że kolejne wpisy tablicy wydadzą się zmienione, nawet jeśli tożsamość obiektów koncepcyjnie pozostaje taka sama. Przed porównaniem znormalizuj wygenerowane znaczniki czasu, losowe identyfikatory i wartości zależne od środowiska, aby łatwiej było dostrzec rzeczywiste zmiany kontraktu.