← Tüm rehberler

JSON nedir? Kuralları ve en sık yapılan hatalar

· 2 dk okuma

JSON, verileri metin olarak taşımak için en yaygın biçimdir. Kuralları azdır ama katıdır: küçük bir virgül fazlası bile dosyanın tamamını geçersiz yapar.

Bir JSON örneği

JSON'da nesneler süslü parantezle, diziler köşeli parantezle yazılır. Değerler metin, sayı, true, false, null, nesne ya da dizi olabilir.

{
  "ad": "Ayşe",
  "yas": 28,
  "aktif": true,
  "diller": ["Türkçe", "İngilizce"],
  "adres": null
}

En sık yapılan hatalar

  1. Son öğeden sonra virgül koymak: {"a": 1,} geçersizdir.
  2. Tek tırnak kullanmak: {'a': 1} geçersizdir. JSON'da hep çift tırnak gerekir.
  3. Anahtarı tırnaksız yazmak: {a: 1} geçersizdir. Anahtarlar da çift tırnaklı metin olmalıdır.
  4. Yorum satırı eklemek: // açıklama ya da /* açıklama */ JSON'da yoktur.
  5. true, false ve null'ı büyük harfle yazmak: True ya da NULL geçersizdir, hep küçük harf.
  6. Sayıda baştaki sıfır: 007 geçersizdir. Sayı 7 olmalıdır ya da metin olarak "007" yazılmalıdır.
  7. Metin içinde kaçışsız çift tırnak ya da satır sonu: "Ali "Veli"" hatalıdır. Doğrusu "Ali \"Veli\"" biçimindedir.
  8. Nesneler arasında virgülü unutmak: {"a": 1 "b": 2} geçersizdir.

Büyük sayılara dikkat

JavaScript ile birlikte çalışıyorsan 9.007.199.254.740.991'den (2^53 − 1) büyük tam sayılar tam olarak saklanamaz. Bu sınırın üstündeki bir kimlik numarası sessizce bozulabilir. Böyle sayıları metin olarak ("12345678901234567890") göndermek daha güvenlidir. Araçlarımız 16 haneden uzun sayı gördüğünde uyarı verir.

Düzenleme ve küçültme

Okumak için girintili (pretty) biçimi, göndermek için tek satırlık küçültülmüş (minified) biçimi kullanırsın. İkisi de aynı veridir. JSON düzenleyici iki işi de yapar, anahtarları alfabetik sıralayabilir ve geçersiz JSON'da hatanın satır ve sütununu gösterir. Verin tarayıcından çıkmaz.

JSON mu CSV mi?

Tablo gibi düz veriler için CSV daha küçük ve Excel ile uyumludur. İç içe ve değişken yapılı veriler için JSON uygundur. Bir CSV'yi düzenlemen gerekirse CSV temizleme aracına bakabilirsin.

Diğer rehberler