JavaScript, web geliştirme dünyasında en yaygın kullanılan programlama dillerinden biridir. Özellikle, dizi ve metin manipülasyonu işlemleri sırasında sıklıkla kullanılan bazı yöntemler bulunmaktadır. Bu yöntemlerden biri de includes() metodudur. Bu yazıda, includes() metodunun ne olduğunu, nasıl kullanıldığını ve kullanım alanlarını detaylı bir şekilde anlatacağım.

includes() Metodu Nedir?

JavaScript includes() metodu, bir dizinin veya metnin belirli bir öğeyi ya da alt metni içerip içermediğini kontrol etmek için kullanılır. Eğer belirttiğiniz öğe veya alt metin, dizide ya da metinde mevcutsa, true, aksi takdirde false döner.

Bu yöntem, hem diziler (arrays) hem de string (metin) verilerinde kullanılabilir. Ancak her iki türde kullanımı arasında küçük farklar vardır. Aşağıda bu farkları detaylıca inceleyeceğiz.

---

includes() Metodunun Kullanımı

1. Dizi (Array) İçerisinde includes() Kullanımı

Dizi içerisindeki bir öğeyi kontrol etmek için includes() metodu oldukça kullanışlıdır. Örneğin, bir alışveriş sepetindeki ürünlerin varlığını kontrol etmek isteyebilirsiniz.

Sözdizimi ( Syntax ) :

array.includes(element, startIndex)

• element: Dizide aramak istediğiniz öğe.
• startIndex(isteğe bağlı): Aramanın başlayacağı indeksi belirtir. Varsayılan olarak 0 değerindedir.

Örnek 1: Basit Kullanım

const meyveler = ['elma', 'muz', 'kiraz'];

console.log(meyveler.includes('muz')); // true
console.log(meyveler.includes('armut')); // false

Yukarıdaki örnekte, includes() metodu “muz” öğesinin dizide olup olmadığını kontrol eder. Sonuç olarak true döner.

Örnek 2: Başlangıç İndeksi Kullanımı

const sayilar = [10, 20, 30, 40, 50];

console.log(sayilar.includes(20, 2)); // false
console.log(sayilar.includes(30, 2)); // true

Bu örnekte, arama işlemi 2. indeks (30) itibariyle başladığı için sonuç farklılık gösterir.

2. String (Metin) İçerisinde includes() Kullanımı

Bir metin içerisinde belirli bir alt metni kontrol etmek için includes() metodu kullanılabilir. Bu, özellikle kullanıcı girişlerini doğrulamak ya da metin analizinde oldukça işe yarar.

Sözdizimi ( Syntax ) :

string.includes(substring, startIndex)

• substring: Metin içinde aranacak alt metin.
• startIndex (isteğe bağlı): Aramanın başlayacağı karakter pozisyonu. Varsayılan değer 0‘dır.

Örnek 3: Metin İçerisinde Arama

const mesaj = "JavaScript öğrenmek çok eğlenceli!";

console.log(mesaj.includes("eğlenceli")); // true
console.log(mesaj.includes("zor")); // false

Burada, “eğlenceli” kelimesinin varlığı kontrol edilir ve sonuç true olarak döner.

Örnek 4: Büyük/Küçük Harf Duyarlılığı

const selam = "Merhaba Dünya";

console.log(selam.includes("merhaba")); // false
console.log(selam.includes("Merhaba")); // true

Görüldüğü üzere, includes() metodu büyük/küçük harf duyarlıdır. Bu nedenle, doğru sonuç almak için yazım şekline dikkat etmelisiniz.

---

includes() Kullanım Alanları

1. Form Doğrulama
   Kullanıcı girişlerinde belirli bir karakterin ya da metnin varlığını kontrol etmek için kullanılabilir.

Örnek: E-posta Kontrolü

const email = "serdar@serdarkaraca.com.tr";

if (!email.includes("@")) {
    console.log("Geçersiz e-posta adresi!");
} else {
    console.log("E-posta adresi geçerli.");
}

2. Yetkilendirme Kontrolleri
   Bir kullanıcının yetkilere sahip olup olmadığını kontrol edebilirsiniz.

Örnek: Rol Kontrolü

const roller = ['admin', 'editor', 'user'];

if (roller.includes('admin')) {
    console.log("Yönetici erişimine sahipsiniz.");
}

3. Filtreleme ve Arama
   Bir veri kümesi üzerinde hızlıca arama ve filtreleme işlemleri yapmak için kullanılabilir.

Örnek: Ürün Arama

const urunler = ['telefon', 'laptop', 'tablet'];

const aranan = 'tablet';
console.log(urunler.includes(aranan) ? "Ürün mevcut." : "Ürün bulunamadı.");

---

includes() ile indexOf Farkı

Bazı durumlarda, includes() yerine eski yöntem olan indexOf kullanılabilir. Ancak indexOf genellikle daha karmaşık sonuçlar döndürür. Örneğin, indexOf sonucu -1 dönerse öğe bulunamamıştır. includes() ise doğrudan true veya false döner ve daha okunaklı bir çözüm sunar.

Karşılaştırma:

const dizi = ['a', 'b', 'c'];

console.log(dizi.includes('b')); // true
console.log(dizi.indexOf('b') !== -1); // true

---

JavaScript includes() metodu, hem diziler hem de metinler üzerinde arama yapmayı kolaylaştıran, modern ve kullanışlı bir yöntemdir. Kullanımı basit olmasına rağmen birçok farklı senaryoda faydalı olabilir.

Eğer JavaScript öğreniyorsanız ya da projelerinizde temiz ve anlaşılır bir kod yazmak istiyorsanız, includes() metodunu kesinlikle kullanmayı alışkanlık haline getirin. Bu yöntem sayesinde kodlarınız daha okunabilir ve bakım yapılabilir hale gelecektir.

---

Javascript ile Tüm “String” Metodlarını Anlattığım Yazıyı Buradan İnceleyebilirsiniz.

---

Yukarıda paylaştığım kodların çalışan bir örneğini aşağıda ki bağlantılardan inceleyebilirsiniz.

Javascript konusuyla ilgili yazdığım tüm yazıları bu bağlantıdan veya github hesabımdan inceyebilirsiniz.