JSON verisini istemeden değiştirmeden biçimlendir

Veriyi değiştirmeden önce söz dizimini kontrol et

JSON’da alan adları tırnak içindedir, metinlerde çift tırnak kullanılır ve değer türleri sınırlıdır. Yorum satırları, sondaki gereksiz virgüller ve tek tırnaklı metinler yapıştırılan örneğin reddedilmesine sık yol açar. Kaynak kodda yazılmış bir JavaScript nesnesi, kendiliğinden geçerli JSON belgesi sayılmaz.

Belge biçimlendirilemiyorsa orijinal yanıtla veya dosyayla karşılaştır. Hata kaybolana kadar gelişigüzel noktalama silmekten kaçın. Böyle yaparak kolayca görünen söz dizimi sorununu, başarıyla okunan ama yanlış alan veya değerler içeren başka bir belgeye dönüştürebilirsin. Önce hangi değişikliğin neden gerektiğini belirlemek, sonradan veri aramaktan daha kolaydır.

Girintiyi yapıyı görünür kılmak için kullan

Belgeyi KitForma JSON Biçimlendiriciye yapıştırıp iki boşluk, dört boşluk veya sekme seç. İşlemi çalıştırdıktan sonra dizileri, iç içe nesneleri ve alanlar arasındaki ilişkileri incele. Sonucu gözden geçirene kadar orijinali sakla. Çok kısa bir örnekle ayarların etkisini görmek, uzun belgede doğru yeri bulmayı kolaylaştırır.

KitForma’nın biçimlendiricisi metinlerin dışındaki boşlukları değiştirirken sayıların yazılışını, alan sırasını, yinelenen anahtarları ve metin kaçışlarını korur. Küçültücü de biçim boşluklarını kaldırmak için aynı yaklaşımı kullanır. Bu işlemler anahtar sıralama, gizli bilgileri temizleme, alan adlarını çevirme veya eksik değerleri kendiliğinden tamamlama amacı taşımaz.

Giriş: {"urun":"defter","adet":2,"aktif":true}
Biçimlendirilmiş:
{
  "urun": "defter",
  "adet": 2,
  "aktif": true
}

Kimlikleri ve yinelenen alan adlarını incele

Uzun hesap veya sipariş kimliği yalnız rakamlardan oluşsa bile çoğu iş akışında tırnak içindeki metin olarak taşınır. Biçimlendirici gönderdiğin sayının yazılışını korur; ancak başka bir uygulama onu daha düşük hassasiyetle sayıya çevirebilir. Gösterimi seçmeden önce veriyi alacak sistemin beklediği türü kontrol et.

Yinelenen alan adları ayrıca incelenmelidir. KitForma biçimlendirme sırasında senin yerine birini sessizce seçmemek için bunları korur. Bu davranış yinelenen anahtar kullanımını önerdiği anlamına gelmez; başka ayrıştırıcılar farklı sonuç üretebilir. Belirsizliği biçimlendirilmiş görünümden çıkarmaya çalışmak yerine amaçlanan veri yapısını kaynağında düzelt.

Uygulamanın beklediğini ayrıca doğrula

Söz dizimi doğru bir belgede müşteri adı eksik, para birimi beklenmedik veya tarih yanlış biçimde olabilir. KitForma biçimlendiricisi uygulamana özel JSON Schema doğrulaması yapmaz; isteğin kabul edilip edilmeyeceğini öğrenmek için API’ye bağlanmaz. Bu yüzden başarılı sonuç, yalnız biçimlendirme adımının tamamlandığını gösterir.

Küçük ama temsilî örnek kullanıp gerekli alanları uygulamanın belgeleriyle karşılaştır. Yapılandırma değiştiriyorsan önceki ve sonraki metni incele, ardından dosyayı kullanılacağı ortamda test et. Düzenli girinti, herhangi bir ayarın doğru veya güvenli olduğunu kanıtlamaz. Özellikle tür değişikliklerini görünüm değişikliğiyle karıştırmamaya dikkat et.

1. En dış değerin beklenen nesne veya dizi olduğunu doğrula.
2. Biçimlendirmeden sonra önemli değerleri ve türleri kontrol et.
3. Belgeyi kullanmadan önce alıcı uygulamanın kendi doğrulamasını çalıştır.

Tarayıcıdaki işi yönetilebilir büyüklükte tut

Giriş 200.000 UTF-16 kod birimiyle, iç içe yapı ise 100 seviyeyle sınırlıdır. Desteklenen sonlu sayı aralığının dışındaki değerler reddedilir. Çok büyük yanıtta, JSON metnini veya nesneyi ortasından kesmek yerine daha küçük ama temsilî bir dışa aktarma iste. Rastgele kesilmiş içerik doğal olarak geçersiz belge oluşturabilir.

Metin cihazında işlenir; kopyaladığın çıktı ve indirdiğin dosyalar yine uygun şekilde saklanmalıdır. Bir örneği başkasıyla paylaşmadan önce sırları kaldır. Sonraki adım CSV dönüşümüyse iç içe değerler ve sayı hassasiyeti için o aracın ayrı kurallarını incele; biçimlendirme başarısı tabloya kayıpsız dönüşüm garantisi değildir.