Cara Cek Array di JavaScript: Panduan untuk Pemula

Array adalah tipe data yang sering dipakai, tapi bagaimana memastikan sebuah nilai benar-benar array? Simak cara cek array di JavaScript dengan isArray dan tips praktis lainnya.

Layar komputer menampilkan kode JavaScript dengan sorotan pada Array.isArray untuk mengecek array

Kamu punya variabel berisi data dari server, lalu ingin menjalankan map atau forEach. Saat dijalankan, muncul error data.map is not a function. Ternyata data itu bukan array. Bagaimana cara cek array di JavaScript dengan tepat? Pembahasan berikut mencakup cara mengenali array, membedakannya dari objek biasa, dan kesalahan yang sering terjadi saat memeriksa tipe data.

Mengapa typeof Tidak Cukup untuk Cek Array

JavaScript punya operator typeof untuk mengetahui tipe data. Namun, typeof [1, 2, 3] menghasilkan 'object', bukan 'array', karena array di JavaScript sebenarnya objek khusus. Mengandalkan typeof saja tidak bisa membedakan array dari objek biasa, jadi perlu metode lain yang lebih spesifik.

Banyak pemula terjebak di sini. Mereka memeriksa dengan typeof data === 'array' dan selalu mendapat false, sehingga logika program tidak berjalan sesuai harapan.

Menggunakan Array.isArray() untuk Pengecekan Akurat

Array.isArray() mengembalikan true hanya jika nilai yang diberikan adalah array, dan false untuk tipe lain. Contohnya:

console.log(Array.isArray([1, 2, 3])); // true
console.log(Array.isArray({a: 1})); // false
console.log(Array.isArray('hello')); // false
console.log(Array.isArray(123)); // false

Array.isArray() bekerja dengan baik bahkan untuk array yang dibuat dengan cara berbeda, termasuk array dari iframe lain. Dokumentasi JavaScript modern merekomendasikan metode ini.

Jika kamu sering bekerja dengan objek dan array, penting juga memahami cara menyalinnya tanpa referensi. Baca panduan Cara Menyalin Objek dan Array di JavaScript Tanpa Referensi agar tidak mengalami bug akibat referensi yang sama.

Alternatif: instanceof Array

Sebelum Array.isArray() tersedia, orang menggunakan instanceof. Contohnya [1,2,3] instanceof Array menghasilkan true. Cara ini punya kelemahan: jika array berasal dari konteks eksekusi lain, misalnya iframe, instanceof bisa menghasilkan false karena perbedaan prototipe. Array.isArray() lebih disarankan untuk pengecekan yang konsisten.

Kamu mungkin juga menemukan trik lama seperti Object.prototype.toString.call([]) === '[object Array]'. Ini juga berfungsi, tetapi lebih panjang dan kurang terbaca. Untuk kode sehari-hari, gunakan Array.isArray().

Tips Praktis: Kapan dan Di Mana Memeriksa Array

Pengecekan array sering diperlukan saat menerima data dari API, parameter fungsi, atau input pengguna. Beberapa tips agar pengecekan tidak berlebihan tetapi tetap aman:

  • Gunakan Array.isArray() sebelum memanggil metode array seperti map, filter, atau reduce.
  • Jika kamu membuat fungsi yang menerima argumen berupa array, tambahkan pengecekan di awal untuk memberikan pesan error yang jelas.
  • Hindari pengecekan berulang-ulang di dalam loop; cukup periksa sekali di luar loop.
  • Untuk data yang kompleks, pertimbangkan validasi lebih lanjut, misalnya memastikan setiap elemen memiliki properti yang diharapkan.

Contoh fungsi yang aman:

function prosesData(data) {
  if (!Array.isArray(data)) {
    throw new Error('Data harus berupa array');
  }
  return data.map(item => item * 2);
}

Pengecekan ini menghindari error yang membingungkan dan memudahkan debugging.

Studi Kasus: Memfilter Data yang Mungkin Array

Misalnya kamu mengambil data dari API yang bisa mengembalikan array atau objek tunggal, lalu ingin memfilter data berdasarkan kriteria tertentu. Jika data bukan array, bungkus dalam array agar konsisten. Perhatikan contoh berikut:

let response = await fetch('/api/data');
let data = await response.json();
if (!Array.isArray(data)) {
  data = [data];
}
let filtered = data.filter(item => item.aktif);

Pendekatan ini membuat kode lebih tahan terhadap variasi bentuk data. Untuk teknik memfilter objek yang lebih dalam, lihat Cara Memfilter Data Objek di JavaScript dengan Benar.

Kesalahan Umum Saat Cek Array

Beberapa kesalahan yang sering terjadi:

  • Menganggap typeof bisa mendeteksi array. Selalu gunakan Array.isArray().
  • Menggunakan instanceof tanpa mempertimbangkan konteks eksekusi yang berbeda.
  • Memeriksa panjang array (array.length) untuk memastikan itu array. Objek juga bisa memiliki properti length, jadi tidak akurat.
  • Lupa bahwa null juga bertipe 'object' menurut typeof, sehingga Array.isArray(null) mengembalikan false dengan benar, tetapi pengecekan typeof null === 'object' bisa menyesatkan.

Selalu gunakan Array.isArray() untuk kejelasan dan keandalan.

Ringkasan

Mengecek array di JavaScript tidak bisa hanya mengandalkan typeof. Gunakan Array.isArray() sebagai cara utama. Metode ini akurat, mudah dibaca, dan bekerja di berbagai situasi. Terapkan pengecekan di tempat yang tepat, seperti saat menerima data dari luar atau sebelum memanggil metode array. Dengan begitu, kode kamu lebih stabil dan terhindar dari error yang tidak perlu.

Pertanyaan yang Sering Diajukan

Apakah typeof bisa membedakan array dan objek?

Tidak. typeof mengembalikan 'object' untuk array maupun objek biasa. Untuk membedakannya, gunakan Array.isArray().

Apakah Array.isArray() didukung di semua browser?

Ya, Array.isArray() didukung di semua browser modern dan juga Node.js. Untuk browser sangat lama, diperlukan polyfill, tetapi umumnya tidak perlu lagi.

Bagaimana cara mengecek array yang kosong?

Gunakan Array.isArray(arr) && arr.length === 0. Ini memastikan bahwa nilai tersebut benar-benar array dan tidak memiliki elemen.