includes în JavaScript

sir.includes(cauta, pozitie)
tablou.includes(valoare)

Ce face includes

includes răspunde cu true sau false la întrebarea „conține?”. Merge atât pe șiruri de caractere, cât și pe tablouri.

Pe șiruri, căutarea ține cont de literele mari și mici. Pe tablouri, comparația este strictă (ca la ===), cu o excepție utilă: găsește și NaN.

Dacă ai nevoie de poziția unde a fost găsit textul, folosește indexOf, care returnează -1 când nu găsește nimic.

Parametri

Parametru	Descriere
cauta / valoare	Textul sau valoarea căutată.
pozitie	Opțional. De unde începe căutarea.

Ce returnează

true sau false.

Exemple

Exemplul 1: Într-un text

const titlu = "Ghid complet JavaScript pentru începători";

console.log(titlu.includes("JavaScript"));
console.log(titlu.includes("javascript"));
console.log(titlu.toLowerCase().includes("javascript"));

Rezultat

true
false
true

Exemplul 2: Într-un tablou

const roluri = ["editor", "autor"];

if (roluri.includes("editor")) {
  console.log("Poate publica articole");
}
console.log(roluri.includes("admin"));

Rezultat

Poate publica articole
false

Exemplul 3: Poziția cu indexOf

const fisier = "raport-final.pdf";

console.log(fisier.indexOf("final"));
console.log(fisier.indexOf("docx"));

Rezultat

7
-1

Greșeli frecvente

• Cauți un obiect într-un tablou de obiecte: [{ id: 1 }].includes({ id: 1 }) dă false, pentru că sunt obiecte diferite. Folosește find sau some.
• Cauți un număr într-un tablou de texte: ["1", "2"].includes(1) dă false.

Comenzi înrudite

• find: Returnează primul element care îndeplinește o condiție.
• filter: Creează un tablou nou doar cu elementele care îndeplinesc o condiție.
• slice: Extrage o bucată dintr-un text sau dintr-un tablou, fără să modifice originalul.