JSON Toolkit

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.

Pemula±6 menit bacaDiterbitkan 2026-11-20Diperbarui 2026-11-20
Sampul pengantar struktur array dan objek JSON

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:

  1. 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.
  2. Pisahkan pasangan dengan koma dan jangan pernah meninggalkan koma setelah pasangan terakhir. {"a": 1, "b": 2,} gagal dengan Unexpected token } pada kurung kurawal penutup.
  3. 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.
  4. 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.