JSON Karşılaştırma (JSON Diff)

İki belgeyi soldaki ve sağdaki kutuya yapıştır ya da dosyaları kutuların üzerine sürükle. Karşılaştırma sen yazarken çalışır; fark ağacında eklenen, silinen, değeri değişen ve tipi değişen her düğüm ayrı renkle ve kendi anahtar yoluyla gösterilir. Belgeler tarayıcıdan çıkmaz, sunucuya yüklenmez.

Metin karşılaştırıcısı satırlara bakar. Bir belgeyi yeniden biçimlendirmek, girintiyi değiştirmek ya da anahtarları başka sırada yazmak satır bazlı diff'te yüzlerce fark üretir; oysa tek bir değer bile değişmemiştir. Yapısal karşılaştırma belgeyi önce okur: nesneyi anahtar kümesi, diziyi öğe dizisi olarak görür. Sonuçta yalnızca gerçekten değişen değerler listelenir.

Hayır. JSON standardında bir nesnenin anahtarları sırasızdır; {"a":1,"b":2} ile {"b":2,"a":1} aynı nesnedir. Bu araç ikisi arasında fark göstermez, ama yalnızca sıranın değiştiğini fark ederse bunu ayrıca söyler; böylece yeniden yazılmış bir dosyada başka bir şeyin değişmediğinden emin olursun.

Varsayılan olarak evet, ama araya giren veya çıkan öğeler bulunarak; böylece listenin başına bir kayıt eklendiğinde geri kalan her şey değişmiş görünmez. Kayıt listelerinde “Anahtara göre” seçeneğini aç: öğeler id, uuid, key gibi bir kimlik alanına göre eşleştirilir. O zaman listenin başına taşınan bir kayıt silinip eklenmiş değil, yer değiştirmiş olarak görünür. Kimlik alanının adını kendin de yazabilirsin.

Çünkü JSON'da biri sayı, diğeri metindir ve bunları tüketen kodun çoğu için bu ciddi bir fark: bir API sürümünde sayı dönen alan diğerinde metne dönmüşse, karşılaştırmanın bunu göstermesi gerekir. Ayrımı önemsemiyorsan “Sayı ve metni aynı say” seçeneğini açabilirsin; bu durumda araç patch'in artık birebir hedef belgeyi üretmediğini de söyler.

Değil, ve bu araç ikisini ayırır. Bir anahtarın değeri null ise anahtar vardır ve değeri boştur; anahtar hiç yoksa alan tanımlı değildir. Üretilen JSON Patch'te de bu ayrım korunur: birinde replace, diğerinde remove ya da add işlemi çıkar.

JSON Patch, bir belgeyi diğerine çeviren işlemlerin listesidir ve kendisi de JSON'dur. Bir HTTP isteğinin gövdesinde gönderebilir, denetim kaydına yazabilir, iki yapılandırma sürümü arasındaki değişikliği sürüm geçmişinde saklayabilirsin. Bu araç patch'i üretir, ardından ilk belgeye uygular ve sonucun ikinci belge olup olmadığını sınayıp sonucu ekranda yazar.

Standart bunu yasaklamaz; okuyucuların çoğu son değeri alır, bazıları ilkini. Yani belge sessizce farklı yorumlanabilir. Bu araç belgeyi kabul eder ama tekrarı yutmaz: tekrarlanan anahtarı, satır numarasıyla birlikte uyarı olarak gösterir.

Karşılaştırma durur ve o kutunun altında hatanın nedeni satır ve sütun numarasıyla yazılır: kapanmamış parantez, fazladan virgül, tek tırnak, tırnaksız anahtar, geçersiz sayı gibi durumlar ayrı ayrı adlandırılır. Tarayıcının kendi hata mesajı yerine, nerede ne beklendiğini söyleyen bir cümle görürsün.

Hayır. Okuma, karşılaştırma ve patch üretimi dahil her şey tarayıcında çalışır; belgeler ne yüklenir ne saklanır. Bu yüzden üretim yapılandırmaları, müşteri verisi içeren API yanıtları ve kişisel kayıtlar için de kullanılabilir.