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.