JSON Biçimlendirici ve Doğrulayıcı

JSON formatlayıcı, ham, sıkıştırılmış veya kötü biçimlendirilmiş JSON verilerini alıp, insan tarafından okunabilir hale getirmek için uygun girintileme, satır sonları ve boşluklarla yeniden biçimlendiren bir araçtır. Çoğu JSON formatlayıcı ayrıca doğrulama, sözdizimi vurgulama, hata tespiti ve bazen anahtar sıralama, sıkıştırma ve ağaç görünümünde gezinme gibi ek özellikler de içerir. Ücretsiz çevrimiçi JSON formatlayıcımız hem formatlama hem de doğrulamayı tek bir araçta birleştirerek, ayrıntılı hata raporlamasıyla anında temiz çıktı sunar.

JSON, JSON belirtiminin katı kurallarını ihlal ettiğinde geçersiz olur. En yaygın nedenler şunlardır: - Sondaki virgüller — bir nesne veya dizideki son öğeden sonra virgül bulunması - Eksik çift tırnak — nesne anahtarları veya dize değerlerinin etrafında çift tırnak olmaması - Tek tırnak kullanımı — çift tırnak yerine tek tırnak kullanılması (tek tırnak JSON'da geçerli değildir) - Kaçış karakteri kullanılmayan özel karakterler — dizeler içinde kaçış karakteri kullanılmayan ters eğik çizgi veya tırnak gibi karakterler - Geçersiz değerler — JSON karşılığı olmayan undefined, NaN veya Infinity gibi değerler - Eşleşmeyen süslü veya köşeli parantezler — {/} veya [/] çiftlerinin düzgün eşleşmemesi Sözdizimi hatalarının tam konumunu ve niteliğini belirlemek için bir JSON doğrulayıcı kullanın. Çoğu doğrulayıcı, karşılaşılan ilk sorun için satırı, sütunu ve açıklayıcı bir hata mesajını bildirir.

JSON sözdizimi JavaScript nesne değişmez sözdiziminden türetilmiş olsa da, aynı şey değildirler. Temel farklar şunlardır: 1. Anahtarlar çift tırnak içinde olmalıdır — JSON {"key": "value"} gerektirirken, JavaScript {key: "value"} (tırnaksız) ve {'key': 'value'} (tek tırnaklı) kullanımına izin verir. 2. Dize değerleri çift tırnak kullanmalıdır — JSON dizeler için yalnızca çift tırnağa izin verir. JavaScript ise hem tek hem çift tırnağı kabul eder. 3. Sondaki virgül yasaktır — JSON son öğeden sonra virgül kullanımını yasaklar. JavaScript buna izin verir. 4. Sınırlı veri türleri — JSON yalnızca string, number, boolean, null, object ve array türlerini destekler. JavaScript nesneleri fonksiyonlar, undefined, Date, Map, Set ve diğer özel türleri içerebilir. 5. Yorum yoktur — JSON yorumları desteklemez. Kaynak koddaki JavaScript nesneleri yorum içerebilir. Bu, bir JavaScript nesnesini yazıp JSON olarak adlandıramayacağınız anlamına gelir — JSON.stringify() ile serileştirilmeli veya katı JSON kurallarına göre yazılmalıdır.

Hayır, resmi JSON belirtimi (RFC 8259) yorumları desteklemez. JSON minimal, dilden bağımsız bir veri değişim formatı olarak tasarlanmıştır ve yorumlar, ayrıştırıcıların diller arasında basit ve tutarlı kalması için kasıtlı olarak dahil edilmemiştir. Yorumlara ihtiyacınız varsa birkaç seçeneğiniz vardır: - JSONC (Yorumlu JSON) — VS Code ve diğer araçlar tarafından yapılandırma dosyaları için kullanılır. JSONC, // satır yorumlarına ve / / blok yorumlarına izin verir. - YAML veya TOML — Yorumları yerel olarak destekleyen alternatif yapılandırma formatları. - Kural tabanlı meta veri — İnsan tarafından okunabilir notları depolamak için JSON nesnelerinizde "_comment" veya "//" gibi bir anahtar kullanın. Bunun, yükünüze veri eklediğini unutmayın. - Ayrıştırmadan önce yorumları kaldırma — JSON'u katı bir ayrıştırıcıya vermeden önce yorumları kaldırmak için bir ön işleme adımı kullanın.

JSON'u çevrimiçi doğrulamak oldukça basittir: 1. JSON verinizi kopyalayın 2. Bir JSON doğrulama aracına yapıştırın 3. Doğrula veya formatla düğmesine tıklayın 4. Araç ya geçerli JSON bildirir ya da sorunun tam konumunu ve açıklamasını içeren bir hata gösterir İyi bir JSON doğrulayıcı şunları yapmalıdır: - Resmi JSON belirtimine (RFC 8259) göre sözdizimini doğrulamalı - Hataların satır ve sütun numarasını göstermeli - Neyin yanlış gittiğini açıklayan açıklayıcı bir hata mesajı sunmalı - İsteğe bağlı olarak JSON'u aynı anda formatlamalı ve güzelleştirmeli - Farklı veri türleri için renk kodlamasıyla sözdizimini vurgulamalı Büyük veya hassas veriler için birçok çevrimiçi doğrulayıcı her şeyi tarayıcınızda istemci tarafında işler, yani verileriniz asla makinenizden ayrılmaz.

Sıkıştırılmış JSON, gereksiz tüm boşlukların kaldırıldığı JSON'dur — boşluklar, sekmeler, satır sonları ve girintiler çıkarılır. Sonuç, tek bir satır (veya çok az satır) halinde kompakt bir metindir: Sıkıştırılmış JSON üretim ortamında birkaç nedenle kullanılır: - Daha küçük dosya boyutu — Yük boyutunu %30-50 veya daha fazla azaltabilir - Daha hızlı ağ aktarımı — İletilecek daha az veri, daha düşük gecikme anlamına gelir - Azaltılmış bant genişliği maliyetleri — Özellikle yüksek trafikli API'ler ve mobil uygulamalar için önemlidir Ödünleşim, sıkıştırılmış JSON'un insanlar için temelde okunamaz olmasıdır. Hata ayıklama veya inceleme için sıkıştırılmış JSON'u okunabilir bir yapıya dönüştürmek üzere bir JSON güzelleştirme aracı kullanın.

JSON'u güzelleştirmek için çeşitli komut satırı araçları mevcuttur: jq ile (en popüler, ayrıca kurulur): Python ile (çoğu sistemde yerleşiktir): Node.js ile: curl ile (bir API yanıtını güzelleştirme): jq aracı, renklendirilmiş çıktısı, sorgu yetenekleri ve sağlam hata yönetimi için önerilir.

JSON Schema, JSON belgelerini açıklamanıza ve doğrulamanıza olanak tanıyan bir sözlüktür. Bir JSON belgesinin karşılaması gereken yapıyı, veri türlerini ve kısıtlamaları tanımlar. Bunu, JSON verileriniz için bir sözleşme veya belirtim olarak düşünebilirsiniz. JSON Schema'nın temel yetenekleri: - Tür doğrulama — Bir değerin string, number, boolean, array, object veya null olması gerektiğini belirtme - Zorunlu alanlar — Belirli özellikleri zorunlu olarak işaretleme - Değer kısıtlamaları — Minimum/maksimum değerler, dize desenleri (regex) ve izin verilen değerler (enum) belirleme - Dizi doğrulama — Dizi uzunluğunu, öğe türlerini ve benzersizliği kontrol etme - İç içe doğrulama — İç içe nesneler ve diziler için şemalar tanımlama - Koşullu doğrulama — Diğer alanların değerlerine göre farklı kurallar uygulama Örnek JSON Schema: JSON Schema, API istek gövdelerini, yapılandırma dosyalarını ve hizmetler arasındaki veri alışverişi sözleşmelerini doğrulamak için yaygın olarak kullanılır.