JSON Diff Karşılaştır

JSON Diff Nedir?

// 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 }]

Temel Özellikler

Örnekler

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

Nasıl Kullanılır

1. 1

   Her iki JSON belgesini yapıştırın

   Orijinal (sol) ve değiştirilmiş (sağ) JSON'u yapıştırın. Canlı diff siz yazarken oluşturulur; büyük girişlerde (>200 KB) manuel Diff düğmesine geçilir.

2. 2

   Gürültüyü filtreleyin

   Bir ön ayara (Zaman Damgaları / Kimlikler / İz) tıklayın veya Yoksay yollarına Extended JSON Pointer kalıpları yapıştırarak ilgisiz alanları çıkarın.

3. 3

   İhtiyacınız olan görünümü seçin

   İnsan incelemesi için Yan Yana, makine uygulanabilir işlemler için JSON Patch (RFC 6902). Yapılandırmayı bir takım arkadaşıyla paylaşmak için Paylaşım Bağlantısı'nı kullanın.

Yaygın Diff Hataları

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

Yaygın Kullanım Senaryoları

API Yanıt Regresyonu

Hazırlık ile üretim yanıtlarını karşılaştırın; yalnızca anlamlı veri yükü değişikliklerini ortaya çıkarmak için zaman damgalarını ve istek kimliklerini yoksayın.

CI Anlık Görüntü Test Hataları

Başarısız bir Jest/Vitest anlık görüntüsündeki gerçek ile beklenen değerleri yapıştırın. Gürültüyü filtreleyin ve gerçek değişikliği saniyeler içinde bulun.

package-lock / yarn.lock Çakışmaları

Bağımlılıkları ada göre hizalayarak birleştirme çakışmalarını çözün; anahtar sırası ve ilgisiz alanlar gürültü olmaktan çıkar.

K8s / Helm Değerleri Denetimi

Ortamları, volumeMounts ve portları ada göre eşleştirin. Kasıtsız sıralama değişikliklerini gerçek yapılandırma düzenlemelerinden ayırt edin.

i18n Çeviri Kapsamı

en.json ile zh.json'u yapısal olarak karşılaştırarak değer gürültüsü olmadan eksik veya fazla çeviri anahtarlarını bulun.

Terraform / CDK Plan İncelemesi

Plan çıktısını farklı çalıştırmalar arasında karşılaştırın; sayısal tolerans kayan nokta aritmetiğini dengeler, yoksay yolları ARN'leri ve zaman damgalarını çıkarır.

Teknik Detaylar

RFC 6902 Uyumlu Patch Çıktısı

RFC 6901 yollarıyla geçerli JSON Patch işlemleri (add/remove/replace) üretir. fast-json-patch@3.x ve rfc6902 npm paketlerine karşı doğrulanmıştır.

Yinelemeli Geçiş

Açık yığın geçişi (özyineleme yok), olumsuz girişlerde yığın taşmasını önlemek için 100.000 düğüm ve 64 derinlikle sınırlıdır.

Object.is Sayısal Eşitlik

Varsayılan sayısal tolerans 0'dır — Object.is kullanır, bu nedenle -0 ile +0 ayırt edilir. Epsilon tabanlı eşitlik için toleransı 0'ın üzerine ayarlayın.

En İyi Uygulamalar

İncelemeden Önce Filtreleyin

Önce Yoksay yollarını ekleyin (zaman damgaları, kimlikler, iz alanları), sonra diff'i okuyun. Gürültülü diff'leri incelemek, gözü gerçek değişiklikleri atlamaya alıştırır.

Mantıksal Kümeler için Anahtarla Eşleştir

Diziniz sırasız bir kümeyi temsil ediyorsa (ortamlar, kullanıcılar, bağımlılıklar) Anahtarla Eşleştir kullanın. Mantıksal kümelerde sıralı diff neredeyse her zaman yanlıştır.

Girişleri Değil Bağlantıyı Paylaşın

Bir meslektaşınıza filtre yapılandırmanızı göndermek için Paylaşım Bağlantısı'nı kullanın — hassas JSON'u paylaşılan belgelere asla yapıştırmayın. URL yalnızca yapılandırmayı içerir.

Sık Sorulan Sorular