Array dan objek JSON: struktur dan nesting untuk pemula
Intinya: JSON hanya punya dua wadah: objek untuk field bernama, array untuk daftar terurut. Belajar menggabungkannya, memilih yang tepat, dan memperbaiki tiga kesalahan paling sering — array palsu dengan key angka, koma di akhir, dan tanda kutip tunggal.

JSON hanya memberimu dua wadah: objek membawa field bernama, array membawa daftar terurut — dan hampir semua payload rusak dijelaskan oleh tanda kutip, koma, atau daftar yang ditulis sebagai objek palsu.
Satu: JSON hanya punya dua wadah
Serumit apa pun respons API, semuanya berkurang menjadi dua wadah dan enam jenis nilai. Objek adalah koleksi pasangan kunci/nilai dalam kurung kurawal {}; array adalah daftar terurut nilai dalam kurung siku []. Sebuah nilai bisa berupa string, angka, true, false, null — atau kembali objek atau array. Objek dalam array, array dalam objek: rekursi inilah keseluruhan daya ekspresi JSON.
{
"user": { "name": "Ada", "active": true },
"roles": ["admin", "editor"],
"lastLogin": null,
"loginCount": 42
}
Dari situ muncul kesimpulan praktis: saat menghadapi payload yang membingungkan, jangan membaca karakter demi karakter. Periksa dulu karakter terluar, { atau [. Jika objek, bacalah sebagai field bernama; jika array, bacalah sebagai daftar lalu turun tingkat demi tingkat. Diagram sintaks di json.org muat dalam satu halaman justru karena dua struktur plus rekursi menutupi semuanya.
Dua: menulis objek, empat aturan keras
Objek adalah tempat pemula paling banyak keliru, tetapi aturannya berkurang menjadi empat:
- Key harus berupa string dalam tanda kutip ganda.
{name: "Ada"}dan{'name': 'Ada'}sama-sama tidak valid; harus ditulis{"name": "Ada"}. Literal objek JavaScript memperbolehkan key telanjang dan kutip tunggal, JSON tidak — inilah kebingungan paling umum antara keduanya. - Pisahkan pasangan dengan koma dan jangan pernah meninggalkan koma setelah pasangan terakhir.
{"a": 1, "b": 2,}gagal denganUnexpected token }pada kurung kurawal penutup. - Key sebaiknya unik. RFC 8259 merumuskannya sebagai SHOULD, bukan MUST: key duplikat tidak menyebabkan error, tetapi nilai pertama atau terakhir yang dipertahankan bergantung pada implementasi, dan bahasa-bahasa berbeda pendapat. Jangan pernah mengandalkan itu.
- Urutan key tidak bermakna.
{"a":1,"b":2}dan{"b":2,"a":1}adalah objek yang sama; alat diff dan fungsi pembanding mengabaikan urutan key. Jika urutan penting, data itu milik array.
Tiga: menulis array, urutan itu sendiri adalah data
Array menyimpan nilai berdasarkan posisi dan pengindeksan mulai dari 0: dalam ["admin", "editor"], string "editor" adalah [1]. Urutan ini bermakna — inilah perbedaan esensial antara array dan objek. Hasil pencarian yang diurutkan berdasarkan relevansi, entri log yang diurutkan berdasarkan tanggal: informasi semacam ini hanya hidup dalam urutan, dan mengubahnya menjadi objek berarti menghancurkannya.
Dua rekomendasi praktis. Pertama, jaga elemen tetap homogen: [{"id":1},{"id":2}] jauh lebih mudah dikonsumsi daripada [1, "text", true] — legal, tetapi memaksa setiap konsumen menguji tipe di setiap langkah. Kedua, array kosong [] adalah nilai yang sepenuhnya valid — saat field daftar belum berisi, kirim [] alih-alih null, agar konsumen tak perlu memeriksa keberadaan lalu kekosongan.
[
{ "city": "Tokyo", "population": 13960000 },
{ "city": "Delhi", "population": 16780000 }
]
Empat: nesting, empat bentuk payload nyata
Data nyata hanyalah dua wadah ini yang disarangkan satu sama lain, dan polanya berkurang menjadi empat bentuk:
| Bentuk | Penampakan | Penggunaan lazim |
|---|---|---|
| Objek berisi array | {"tags": ["a","b"]} |
Field daftar suatu entitas |
| Array berisi objek | [{"id":1},{"id":2}] |
Daftar record, hasil paginasi |
| Objek berisi objek | {"db": {"host": "..."}} |
Konfigurasi bergrup, blok alamat |
| Array berisi array | [[1,2],[3,4]] |
Matriks, baris tabel |
Respons API khas memakai objek sebagai kulit dan array sebagai isi:
{
"code": 0,
"data": {
"items": [
{ "id": 1, "title": "first" },
{ "id": 2, "title": "second" }
],
"page": 1,
"total": 2
}
}
Jangan bersarang demi bersarang. Lebih dari tiga atau empat tingkat, jalur akses menjadi tak terbaca dan kode konsumen membengkak secara paralel. Field yang selalu bepergian bersama milik subobjek: ganti addrCity dan addrZip dengan address: {city, zip}.
Lima: objek atau array, tabel pengambilan keputusan
| Pertanyaan | Jawaban | Mengapa |
|---|---|---|
| Setiap nilai punya nama? | Objek | Akses lewat key; menambah atau menghapus field tidak merusak apa pun |
| Daftar record yang serupa? | Array | Urutan penting; bisa di-map dan di-filter |
| Butuh pencarian cepat lewat key? | Objek terindeks oleh identifier | Akses O(1) alih-alih penelusuran |
| Beberapa atribut satu entitas? | Objek | Atribut tak punya urutan sendiri |
| Koleksi bertumbuh elemen serupa? | Array | Panjangnya mengembang bebas |
Satu antipola layak disebut khusus: meniru array dengan objek yang key-nya "0", "1", "2". Itu ter-parse tanpa error, tetapi kamu kehilangan semantik panjang dan alat iterasi array sungguhan, dan konsumen harus mengurutkan Object.keys sebelum membaca apa pun. Jika key-nya nomor berurutan, tulis array sungguhan. Kebalikannya juga berlaku: daftar pasangan kunci/nilai seperti [{"key":"theme","value":"dark"}] lebih buruk daripada objek {"theme": "dark"} — kecuali key-nya memang dinamis dan tak dapat dideklarasikan sebelumnya.
Enam: tiga kesalahan sering dan pesannya
| Bentuk salah | Error tipis | Perbaikan |
|---|---|---|
Koma di akhir {"a":1,} |
Unexpected token } |
Hapus koma terakhir |
Kutip tunggal / key telanjang {name:'Ada'} |
Unexpected token ' / Expected property name |
Kutip ganda untuk key dan string, selalu |
Literal Python True / None |
Unexpected token T |
Ganti dengan true / null |
| Array palsu berkunci angka | Tanpa error, semantik salah | Tulis ulang sebagai array sungguhan |
Dua kebiasaan debugging: parser biasanya melaporkan posisi setelah karakter pelakunya, jadi saat melihat position 42, lihat satu-dua karakter ke belakang; dan JSON raksasa satu baris sebaiknya diformat dulu — nomor baris dan kolom selalu mengalahkan offset karakter. Katalog error lengkap ada di tabel lookup error JSON, dan alur triase langkah demi langkah di cara memperbaiki error parse JSON.
Tujuh: setelah menulis, verifikasi strukturnya
JSON tulisan tangan harus selalu melewati parser sebelum diserahkan. Pemeriksaan paling ringan muat dalam satu baris perintah:
python3 -m json.tool config.json > /dev/null && echo OK
jq empty config.json && echo OK
Secara daring, tempelkan konten ke halaman formatter dan validator JSON — error sintaks kembali dengan baris dan kolom. Beralih ke tampilan pohon untuk melihat tipe tiap tingkat sekilas: adakah angka yang terbaca sebagai string, apakah panjang array cocok. Dan saat pembaca bukan teknis, payload array-of-objects bisa dibentangkan menjadi baris dan kolom di halaman JSON ke tabel, yang sekalian memastikan datamu benar-benar berupa daftar record yang teratur.
Pertanyaan tentang field yang seharusnya array, atau tentang membongkar ulang nesting yang terlalu dalam, adalah ranah pemodelan tipe — bacaan berikutnya: enam tipe, presisi angka, dan jebakan encoding.
Bisakah array dan objek JSON dikonversi satu sama lain?
Bisa, tetapi tidak tanpa kehilangan. Mengonversi objek ke array umumnya berarti mengubah key menjadi nilai dan kehilangan akses lewat key; mengonversi array ke objek menuntut menciptakan key untuk setiap elemen, dan asal-usul key itu adalah masalah desain baru. Putuskan berdasarkan cara konsumen membaca data, bukan kenyamanan sintaks.
Bolehkah key objek duplikat?
Secara sintaks boleh — RFC 8259 hanya mengatakan key SEBAIKNYA unik. Tetapi JavaScript menyimpan nilai terakhir sedangkan sebagian pustaka keluarga C menyimpan yang pertama: perilakunya berbeda antar parser. Dalam tanda tangan, diff, atau hash, key duplikat memicu perbedaan langsung. Hindari di sisi produsen dan perlakukan duplikat dari sumber tak dikenal sebagai risiko di sisi konsumen.
Bisakah array berisi nilai berbeda tipe?
Secara sintaks bisa: [1, "a", true] adalah JSON valid. Tetapi array heterogen memaksa konsumen memeriksa tipe di setiap posisi dan sulit dinyatakan dalam schema. Kecuali matriks dan tuple — di mana posisi itulah semantiknya — jagalah array tetap homogen.
Mengapa {name:'json'} gagal validasi?
Karena JSON menuntut tanda kutip ganda di sekeliling setiap key dan setiap nilai string. {name:'json'} adalah literal objek JavaScript, bukan JSON. Ganti dengan {"name": "json"} dan validasi akan lolos. Kutip tunggal, key telanjang, dan komentar adalah milik dialek seperti JSON5/JSONC, yang membutuhkan parser sendiri alih-alih JSON.parse standar.