Apa itu JSON
JSON (JavaScript Object Notation) adalah format teks untuk data terstruktur, dipakai oleh sebagian besar API web dan file konfigurasi. Hanya ada enam jenis nilai: objek, array, string, angka, true atau false, dan null.
{
"name": "SigapTek",
"tags": ["tools", "guides"],
"active": true,
"version": 1.5,
"owner": null
}
Aturan sintaks
- Objek memakai kurung kurawal dengan pasangan
"key": valueyang dipisah koma. - Array memakai kurung siku dengan nilai yang dipisah koma.
- Key dan string harus memakai tanda kutip ganda. Kutip tunggal tidak valid.
- Tidak ada koma setelah item terakhir.
- Tidak ada komentar.
- Angka tidak boleh berawalan nol atau tanda plus, dan tidak ada
NaNatauInfinity. - Karakter khusus di dalam string perlu escape, seperti
\nuntuk baris baru dan\"untuk tanda kutip.
Error yang paling sering ditemui
| Error | Penyebab | Perbaikan |
|---|---|---|
| Unexpected token atau karakter tak terduga | Kutip tunggal, key tanpa kutip, atau karakter nyasar | Pakai kutip ganda untuk semua key dan string |
| Koma di akhir | Koma sebelum } atau ] | Hapus koma terakhir |
| Diharapkan koma | Koma hilang di antara item | Tambahkan koma |
| Input berakhir tiba-tiba | Kurung penutup hilang | Tambahkan karakter penutup |
| Karakter kontrol tanpa escape | Baris baru mentah di dalam string | Ganti dengan \n |
| Komentar tidak diperbolehkan | // atau /* */ di dalam teks | Hapus, atau pakai parser JSON5 atau JSONC jika tool Anda mendukungnya |
Format, validasi, minify
- Format (pretty print) menambah indentasi agar data bersarang mudah dibaca manusia.
- Validasi memeriksa sintaks dan memberi tahu di mana letak kesalahannya.
- Minify menghapus spasi opsional untuk memperkecil ukuran saat transfer.
Ketiganya tidak mengubah datanya. Tempel teks Anda ke JSON Formatter, Validator & Minifier untuk melakukannya di browser. Tool menampilkan baris dan kolom error pertama serta menandai titik tepatnya.
JSON bukan objek JavaScript
Objek literal JavaScript boleh memiliki key tanpa kutip, kutip tunggal, dan koma di akhir. JSON tidak. Untuk menghasilkan JSON valid dari kode, biarkan bahasa pemrogramannya yang melakukannya:
JSON.stringify(obj, null, 2) // JavaScript
json.dumps(obj, indent=2) // Python
json_encode($arr, JSON_PRETTY_PRINT) // PHP
Angka besar dan presisi
Banyak parser mengubah angka menjadi floating point, yang tidak dapat merepresentasikan bilangan bulat di atas 2^53 secara tepat. Jika sebuah ID seperti 12345678901234567890 penting, kirim sebagai string.
Validasi strukturnya juga
Sintaks valid tidak berarti data valid. Untuk memeriksa bahwa field dan tipe wajib ada, gunakan validator JSON Schema di kode Anda.
FAQ
Mengapa JSON saya berjalan di kode tetapi gagal di validator?
Kode Anda mungkin menerima sintaks objek JavaScript. Validator JSON bersifat ketat.
Bolehkah JSON memiliki komentar?
Tidak dalam standar. Sebagian tool menerima JSONC atau JSON5, tetapi itu format yang berbeda.
Amankah menempel JSON privat ke tool online?
Hanya jika tool memprosesnya secara lokal. JSON Formatter berjalan di browser dan tidak mengunggah input Anda. Tetap hindari menempel rahasia aktif di mana pun.