data_object JSON Formatter star

Nasıl Çalışır

JSON (JavaScript Object Notation), sadece "JavaScript'e benzeyen veri" değildir — RFC 8259 standardıyla tanımlanmış, kendi başına katı bir biçimdir. Söz dizimi bir JavaScript nesne ifadesine benzese de kuralları çok daha katıdır: her anahtar ve her metin değeri çift tırnak içinde olmalıdır ("anahtar"), tek tırnak asla geçerli değildir; bir nesne veya dizinin son elemanından sonra virgül — yani trailing comma — sözdizimi hatasıdır; undefined, fonksiyon değeri veya yorum satırı gibi salt JavaScript'e özgü kavramların JSON'da hiçbir karşılığı yoktur. Bu araç, girdiğiniz veriyi tarayıcının kendi JSON.parse() motorundan geçirir — yani gördüğünüz hata, gerçek bir API istemcisinin veya yapılandırma yükleyicisinin de vereceği hatadır.

Örneğin {'id': 12, 'aktif': true,} iki noktada geçersizdir: id etrafındaki tek tırnaklar geçersizdir, true'dan sonraki virgül de geçersizdir (trailing comma). Doğru biçim {"id": 12, "aktif": true}'dur. JSON'unuz doğrulandıktan sonra Güzelleştir, iç içe geçmiş her seviyeyi girintiler — diziler içindeki nesneler içindeki diziler gözle takip edilebilir hale gelir; bu, altı seviye derinlikte kayıp bir parantez ararken kritik önem taşır. Sıkıştır ise tam tersini yapar: gereksiz her boşluğu kaldırıp veriyi tek satıra indirir, depolama ve ağ üzerinden taşıma için boyutu küçültür. Her iki modda da veri birebir aynı kalır, yalnızca insan gözüne yönelik düzen değişir.

Bu tür bir araç günlük geliştirme işinde işe yarar: kod yazmadan önce ham bir API yanıtının gerçek şeklini görmek için yapıştırmak, bir dağıtımı bozmadan önce yapılandırma dosyasındaki sapkın bir virgülü fark etmek, ya da tarayıcı DevTools ağ sekmesinden kopyalanan — genellikle dev bir tek satırdan ibaret — okunmaz bir yükü gözle taranabilir bir şeye dönüştürmek gibi. Bir mobil uygulamanın backend'inden dönen yanıtı incelerken, bir package.json veya tsconfig.json dosyasını elle düzenlerken ya da bir üçüncü taraf API'nin dokümantasyonunda verilen örnek yükü doğrularken de aynı şekilde devreye girer.

Bilinmesi Gerekenler

• Her şey yerel olarak çalışır. Hiçbir metin sunucuya yüklenmez; doğrulama, güzelleştirme ve sıkıştırma tamamen tarayıcınızın JavaScript motorunda gerçekleşir.
• Büyük tam sayılar hassasiyet kaybedebilir. JSON sayıları IEEE 754 çift hassasiyetli kayan noktaya dayanır; 2^53'ü aşan 64-bit ID'ler, string yerine native sayı olarak ayrıştırılırsa sessizce yuvarlanabilir.
• Anahtar sırası spesifikasyon tarafından garanti edilmez, pratikte çoğu ayrıştırıcı ekleme sırasını korusa da buna bağımlı mantık yazmayın.
• Kök seviyedeki değer bir nesne olmak zorunda değildir. Güncel JSON (RFC 8259'a göre) kökte çıplak bir metin, sayı, boole, null veya dizi olmasına da izin verir — "merhaba" ve 42 tek başlarına tamamen geçerli birer JSON belgesidir.