JSON Güzelleştirme ve Doğrulama

Hayır. Bu araç katı JSON’u (RFC 8259) doğrular; bu yüzden sondaki virgüller, // yorumları ve tırnaksız anahtarlar reddedilir. Dosyanızda JSONC yorumları varsa (tsconfig.json, VS Code ayarları) önce bunları temizleyin ya da JSONC’yi anlayan bir ayrıştırıcı kullanın.

Sabit bir üst sınır yok — belgeyi sınırlayan şey tarayıcının bu sekmeye ayırdığı bellektir ve ilk fark ettiğiniz şey bir ret değil, yazarken yaşanan gecikmedir; çünkü biçimlendirici her tuş vuruşunda yeniden çalışır. Birkaç megabayt rahat çalışır; yüzlerce megabaytlık dosyaları komut satırında dosyanın tamamını bellekte tutmak yerine akış olarak okuyan `jq -r` ile işlemek daha doğru olur. Büyük bir belge burada ağır geliyorsa, düzenlemeden önce ağacı daraltmak sayfadaki her şeyden daha çok işe yarar; çünkü daraltılan dallar yeniden çizilmez.

Evet — anahtarlar girdikleri sırayla çıkar ve bu, ayrıştırıcının bir tesadüfü değil, bilinçli bir tercihtir. JSON şartnamesi bir nesnenin sırasız olduğunu söyler; yani bir biçimlendirici teknik olarak sıralama yapmakta serbesttir ve bazıları yapar. Bu da sessizce sorun çıkarır: imzalı bir veri artık doğrulanmaz, bir test verisi anlık görüntüsüyle eşleşmez, önceki sürümle karşılaştırma yerinden oynamış satırlardan oluşan bir yığına döner. Burada hiçbir şey yeniden sıralanmaz, eklenmez ya da çıkarılmaz — yalnızca bayt düzeni değişir, o kadar.

Kaçış dizilerine dönüştürülmek yerine olduğu gibi geçerler. JSON iki biçime de izin verir — bir Kiril harfi doğrudan ya da \u0430 olarak yazılabilir — ve birçok biçimlendirici her kanaldan sağ çıktığı için kaçışlı biçimi seçer. Bunun bedeli, sonucun metni kendilerine ait olan kişiler için okunamaz hale gelmesidir; Çince ürün adlarından oluşan bir dosya sayfalarca ters eğik çizgiye dönüşür. Burada karakterler karakter olarak kalır. Dikkat edilmesi gereken tek nokta, boyut istatistiklerinin UTF-8 baytlarını saymasıdır; yani bir emoji dizisi, karakter sayısından göründüğünden daha ağırdır.

Okuyacak kişi insansa güzelleştirin, makineyse küçültün. İkisi birbirinin tam tersidir ve hiçbiri veriyi değiştirmez: güzelleştirme girinti ve satır sonları ekleyerek yapıyı görünür kılar, küçültme ise yalnızca göz için var olan her baytı siler. Küçültülmüş JSON bir istek gövdesine, derlemeye gömülen bir yapılandırmaya ya da boyutun her aktarımda bedel ödettiği her yere uygundur. Güzelleştirilmiş JSON ise commit’e uygundur; çünkü küçültülmüş dosya tek bir dev satırdır ve ona yapılan her değişiklik farkta o satırın tamamen değişmesi olarak görünür.