Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.includes — provjera prisutnosti podniza

String.prototype.includes provjerava sadrži li tekst zadani podniz i vraća true ili false. Razlikuje velika i mala slova, omogućuje zadavanje početnog položaja i ne prihvaća obične regularne izraze.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

str.includes(searchString)
str.includes(searchString, position)

String.prototype.includes traži doslovni podniz i vraća true ili false bez promjene teksta. Razlikuje velika i mala slova te uspoređuje UTF-16 kodne jedinice: ne normalizira Unicode niti primjenjuje pravila usporedbe specifična za pojedine jezike.

Neobavezni parametar position određuje najraniji indeks početka podudaranja, računajući od nule u UTF-16 kodnim jedinicama. Zadana je vrijednost 0; nakon pretvorbe u broj, razlomački dio skraćuje se prema nuli, a rezultat se ograničava na raspon od 0 do duljine teksta. Ako metoda dođe do koraka pretraživanja, za prazan searchString vraća true, čak i kada zadani položaj premašuje duljinu teksta. Međutim, position se pretvara prije pretraživanja: vrijednost tipa BigInt zadana kao position izaziva TypeError čak i kada je searchString prazan.

Običan objekt RegExp upotrijebljen kao searchString uzrokuje TypeError; formalno o tome odlučuje provjera IsRegExp, koja uzima u obzir Symbol.match. Ostali argumenti pretraživanja pretvaraju se u tekst, pa se izostavljanjem argumenta traži "undefined". Pozivanje metode s vrijednošću null ili undefined kao this uzrokuje TypeError.

Ovo je metoda standardne biblioteke ECMAScripta, a ne Web API. Podršku u određenom pregledniku treba zasebno provjeriti; dostupnost u Nodeu 24 ne dokazuje podršku u preglednicima.

Primjeri

const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));

try {
  text.includes(/Script/);
} catch (error) {
  console.log(error.name);
}

Rezultat

true
false
false
true
TypeError

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori