Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

String.prototype.includes — overenie prítomnosti podreťazca

String.prototype.includes overuje, či text obsahuje zadaný podreťazec, a vracia true alebo false. Rozlišuje veľké a malé písmená, umožňuje určiť počiatočnú pozíciu a neprijíma bežné regulárne výrazy.

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

Syntax

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

String.prototype.includes vyhľadáva doslovný podreťazec a vracia true alebo false bez zmeny textu. Rozlišuje veľké a malé písmená a porovnáva jednotky kódu UTF-16: Unicode nenormalizuje ani nepoužíva pravidlá porovnávania špecifické pre jednotlivé jazyky.

Voliteľný parameter position určuje najskorší index začiatku zhody, počítaný od nuly v jednotkách kódu UTF-16. Predvolená hodnota je 0; po prevode na číslo sa zlomková časť skráti smerom k nule a výsledok sa obmedzí na rozsah od 0 po dĺžku textu. Ak metóda dospeje k samotnému vyhľadávaniu, pri prázdnom searchString vráti true, aj keď zadaná pozícia presahuje dĺžku textu. Hodnota position sa však prevádza pred vyhľadávaním: zadanie hodnoty typu BigInt ako position vyvolá TypeError aj pri prázdnom searchString.

Bežný objekt RegExp použitý ako searchString spôsobí TypeError; formálne o tom rozhoduje test IsRegExp, ktorý zohľadňuje Symbol.match. Ostatné argumenty vyhľadávania sa prevádzajú na text, takže pri vynechaní argumentu sa hľadá "undefined". Volanie metódy s hodnotou null alebo undefined ako this spôsobí TypeError.

Ide o metódu štandardnej knižnice ECMAScript, nie o Web API. Podporu v konkrétnom prehliadači treba overiť osobitne; dostupnosť v Node 24 nedokazuje podporu v prehliadačoch.

Príklady

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);
}

Výsledok

true
false
false
true
TypeError

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje