Array Includes JavaScript: Sintaks dan Contoh Penggunaan

includes merupakan method array yang berfungsi untuk mengetahui apakah sebauh array mengandung nilai tertentu atau tidak, mengembalikan nilai true jika ya atau false jika tidak.

Dengan menggunakan method ini kita tidak perlu melakukan perulangan secara manual untuk mengecek setiap elemen array.

Mari kita pelajari lebih lanjut mulai dari sintaks hingga contoh penggunaannya.

1. Sintaks
2. Contoh
   1. Cek Apakah Array Mengandung Elemen String Tertentu
   2. Cek String Peka Huruf Besar/Kecil
   3. Menggunakan Index Mulai Pencarian

Sintaks

inlcudes(elemenDicari, indeksMulaiPencarian);

Parameter

• elemenDicari: nilai atau elemen yang ingin dicari di dalam array. Untuk string dan karakter, peka huruf besar/kecil.
• indeksMulaiPencarian (opsional): index array untuk memulai pencarian. Default 0.

Nilai Kembalian

Mengembalikan nilai boolean true jika elemenDicari ditemukan di dalam array, atau false jika tidak.

Contoh

Cek Apakah Array Mengandung Elemen String Tertentu

Contoh berikut mengecek apakah array buah memiliki elemen string apel dan anggur.

const buah = ['mangga', 'pisang', 'apel'];

const adaApel = buah.includes('apel');
const adaAnggur = buah.includes('anggur');

console.log(adaApel); // true
console.log(adaAnggur); // false

Cek String Peka Huruf Besar/Kecil

Method includes peka huruf besar/kecil, mari kita buktikan.

Mengapa method includes pada contoh berikut mengembalikan false?

Karena kita menggunakan string Apel (A menggunakan huruf besar) yang ada adalah apel (menggunakan huruf kecil semua).

const buah = ['mangga', 'pisang', 'apel'];

const adaApel = buah.includes('Apel');

console.log(adaApel); // false

Menggunakan Index Mulai Pencarian

Contoh berikut mencari elemen string mangga mulai dari indeks 1. Karena mangga berada di indeks 0, maka tidak ditemukan.

const buah = ['mangga', 'pisang', 'apel'];

const adaMangga = buah.includes('mangga', 1);

console.log(adaMangga); // false