Cara Mengatasi Cannot Convert Undefined Or Null To Object pada Object.Keys dan Entries

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.user tidak ada.
  • Hasil localStorage.getItem() kosong sehingga bernilai null.
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:

  1. Reproduksi error dan cetak nilainya dengan console.log(data).
  2. Periksa tipenya dengan typeof data dan pastikan bukan string JSON mentah.
  3. Beri fallback objek kosong memakai ?? {}.
  4. 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 {}, bukan null, bila nilai akhirnya objek.
  • Cek response.ok sebelum 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.