Cara Membaca Error JSON: Penyebab, Contoh, dan Cara Memperbaikinya

JSON sering digunakan untuk API, konfigurasi aplikasi, webhook, export data, integrasi sistem, dan penyimpanan struktur data ringan. Format ini populer karena ringkas, mudah dibaca, dan didukung hampir semua bahasa pemrograman.

Namun, JSON juga ketat. Satu koma berlebih, tanda kutip yang salah, atau kurung yang tidak seimbang bisa membuat seluruh data dianggap tidak valid. Akibatnya, API gagal dibaca, konfigurasi error, atau aplikasi tidak bisa memproses data.

Artikel ini membahas penyebab error JSON yang paling sering terjadi, contoh kesalahan, dan cara memperbaikinya.

Apa Itu Error JSON?

Error JSON adalah kondisi ketika struktur JSON tidak sesuai aturan. JSON valid harus mengikuti format tertentu: key harus memakai tanda kutip ganda, string harus ditulis dengan benar, object memakai kurung kurawal, array memakai kurung siku, dan setiap pasangan key-value harus dipisahkan dengan koma.

Contoh JSON valid:

{
  "name": "SayaWRT",
  "type": "tool",
  "active": true
}

Contoh JSON tidak valid:

{
  name: "SayaWRT",
  "type": "tool",
  "active": true,
}

JSON kedua salah karena key name tidak memakai tanda kutip ganda dan ada koma berlebih setelah value terakhir.

Penyebab Error JSON yang Paling Sering Terjadi

Key Tidak Menggunakan Tanda Kutip Ganda

Dalam JSON, nama key wajib menggunakan tanda kutip ganda.

Salah

{
  name: "SayaWRT"
}

Ini berbeda dari JavaScript object. Di JavaScript, key tanpa kutip bisa valid. Di JSON murni, itu tidak valid.

Menggunakan Tanda Kutip Tunggal

JSON hanya menerima tanda kutip ganda untuk string.

Salah

{
  "name": 'SayaWRT'
}

Benar

{
  "name": "SayaWRT"
}

Koma Berlebih di Akhir Object atau Array

JSON tidak mengizinkan trailing comma, yaitu koma setelah item terakhir.

Salah

{
  "name": "SayaWRT",
  "type": "tool",
}

Benar

{
  "name": "SayaWRT",
  "type": "tool"
}

Ini salah satu penyebab error JSON paling umum.

Kurung Tidak Seimbang

Object harus dibuka dan ditutup dengan kurung kurawal {}. Array harus dibuka dan ditutup dengan kurung siku [].

Salah

{
  "tools": [
    "Pasfoto Online",
    "JSON Reader"
}

Benar

{
  "tools": [
    "Pasfoto Online",
    "JSON Reader"
  ]
}

Jika satu kurung hilang, parser tidak bisa memahami struktur data.

Value Tidak Sesuai Tipe Data JSON

JSON mendukung beberapa tipe data: string, number, boolean, null, object, dan array. Value seperti undefined, function, atau komentar tidak valid dalam JSON.

Salah

{
  "status": undefined
}

Benar

{
  "status": null
}

Gunakan null jika data belum tersedia.

Cara Membaca Pesan Error JSON

Saat JSON tidak valid, validator biasanya menampilkan pesan error seperti:

Unexpected token } in JSON

Ini biasanya terjadi karena koma antar property hilang.

Salah

{
  "name": "SayaWRT"
  "type": "tool"
}

Benar

{
  "name": "SayaWRT",
  "type": "tool"
}

Pesan error JSON tidak selalu langsung menunjukkan akar masalah. Kadang parser hanya memberi tahu posisi ketika error terdeteksi, bukan posisi awal kesalahan. Karena itu, cek beberapa baris sebelum lokasi error.

Cara Memperbaiki JSON Error

Langkah paling aman adalah memvalidasi JSON menggunakan JSON Reader. Paste data JSON, jalankan validasi, lalu lihat pesan error yang muncul. SayaWRT sudah menyediakan JSON Reader untuk validasi, beautify, minify, tree viewer, pencarian key/value, copy, dan download

Setelah error ditemukan, lakukan ini:

1. pastikan semua key memakai tanda kutip ganda;
2. pastikan semua string memakai tanda kutip ganda;
3. hapus koma setelah item terakhir;
4. cek kurung {}, [];
5. ganti undefined dengan null;
6. hapus komentar;
7. gunakan beautify agar struktur mudah dibaca.

Untuk JSON besar, jangan membaca semuanya secara manual. Gunakan tree viewer dan pencarian key/value agar lebih cepat menemukan bagian yang bermasalah.

Kesimpulan

Error JSON biasanya terjadi karena kesalahan kecil: koma berlebih, tanda kutip salah, key tidak valid, kurung tidak seimbang, atau value yang tidak didukung JSON.

Cara terbaik memperbaikinya adalah menggunakan validator, membaca pesan error, lalu mengecek struktur di sekitar baris yang bermasalah. Untuk proses lebih cepat, gunakan JSON Reader SayaWRT agar JSON bisa divalidasi, dirapikan, dipadatkan, dan dibaca dalam bentuk tree viewer.