Error cannot convert undefined or null to object muncul karena kamu memanggil Object.keys(), Object.values(), atau Object.entries() dengan nilai null atau undefined. Perbaikan tercepat: beri nilai default {} sebelum data masuk ke fungsi Object. Contoh: Object.keys(data ?? {}).
Arti Error Cannot Convert Undefined Or Null To Object
Pesan lengkapnya biasanya TypeError: Cannot convert undefined or null to object. Ini dilempar runtime browser maupun Node.js modern ketika fungsi bawaan Object menerima argumen yang tidak bisa diubah menjadi objek.
Pemicunya bukan hanya Object.keys. Object.values, Object.entries, Object.assign, dan spread {...data} ikut gagal bila data bernilai null atau undefined.
Bedakan dengan dua error lain. Cannot read properties of null berarti kamu mengakses properti, misalnya user.name. Cannot convert undefined or null to object berarti kamu memproses keseluruhan nilai sebagai objek.
Penyebab Umum dan Tabel Troubleshooting
Kasus paling sering:
- Respons fetch/API belum tiba atau gagal, lalu langsung diolah.
- State awal React atau Vue diset
null, bukan{}. - Properti nested hilang, misalnya
res.data.usertidak ada. - Hasil
localStorage.getItem()kosong sehingga bernilainull.
| Error/Kondisi | Penyebab | Solusi |
|---|---|---|
Object.keys(data) gagal |
data masih null |
Gunakan data ?? {} |
Object.entries(res.user) gagal |
user tidak ada di API |
Validasi res.user dulu |
Spread {...saved} gagal |
localStorage kosong |
Fallback ke objek kosong |
Cara Memperbaiki dengan Pengecekan dan Nilai Default
Ikuti urutan ini:
- Reproduksi error dan cetak nilainya dengan
console.log(data). - Periksa tipenya dengan
typeof datadan pastikan bukan string JSON mentah. - Beri fallback objek kosong memakai
?? {}. - Validasi sebelum memanggil
Object.keys, terutama untuk data API.
// SALAH: data bisa null dari API atau localStorage
Object.keys(data);
// BENAR: aman untuk null dan undefined
const safeData = data ?? {};
Object.keys(safeData);
// BENAR untuk parameter fungsi
function hitungField(user = {}) {
return Object.keys(user).length;
}
Kode salah langsung memproses data tanpa tahu isinya. Operator ?? mengganti null dan undefined dengan {}, tetapi membiarkan objek asli lewat. Parameter default user = {} melindungi fungsi bila pemanggil lupa mengirim argumen.
Cara Mencegah agar Error Tidak Berulang
Inisialisasi state sebagai objek kosong sejak awal. Untuk data API, periksa bentuk respons sebelum dipakai. Untuk JSON.parse, pastikan stringnya ada dan valid.
Jangan memanggil Object.keys langsung pada parameter fungsi tanpa default. Satu respons kosong cukup membuat seluruh halaman berhenti.
- Gunakan state awal
{}, bukannull, bila nilai akhirnya objek. - Cek
response.oksebelum memproses JSON dari fetch. - Setelah
JSON.parse, pastikan hasilnya objek. - Buat fungsi util seperti
toObject(data)untuk normalisasi.
FAQ
Kenapa Object.keys(null) memicu error ini?
Karena Object.keys wajib menerima objek, sedangkan null tidak dapat dikonversi menjadi objek.
Apakah optional chaining cukup untuk error ini?
Tidak. data?.name aman untuk akses properti, tetapi Object.keys(data) tetap butuh fallback seperti ?? {}.
Kapan memakai try catch untuk Object.entries?
Pakai hanya untuk data eksternal yang bentuknya tidak pasti, misalnya hasil parse JSON rusak, bukan untuk menggantikan validasi biasa.