CKTIS / JavaScript
String.prototype.includes — ověření přítomnosti podřetězce
String.prototype.includes ověřuje, zda text obsahuje zadaný podřetězec, a vrací true nebo false. Rozlišuje velká a malá písmena, umožňuje zadat počáteční pozici a nepřijímá běžné regulární výrazy.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.includes(searchString)
str.includes(searchString, position)String.prototype.includes vyhledává doslovný podřetězec a vrací true nebo false, aniž by text měnila. Rozlišuje velká a malá písmena a porovnává jednotky kódu UTF-16: Unicode nenormalizuje ani nepoužívá pravidla porovnávání specifická pro jednotlivé jazyky.
Volitelný parametr position určuje nejčasnější index začátku shody, počítaný od nuly v jednotkách kódu UTF-16. Výchozí hodnota je 0; po převodu na číslo se zlomková část zkrátí směrem k nule a výsledek se omezí na rozsah od 0 do délky textu. Pokud metoda dospěje k samotnému vyhledávání, pro prázdný searchString vrátí true, i když zadaná pozice přesahuje délku textu. Hodnota position se však převádí před vyhledáváním: předání hodnoty typu BigInt jako position vyvolá TypeError i při prázdném searchString.
Běžný objekt RegExp použitý jako searchString způsobí TypeError; formálně o tom rozhoduje test IsRegExp, který zohledňuje Symbol.match. Ostatní argumenty pro vyhledávání se převádějí na text, takže při vynechání argumentu se hledá "undefined". Volání metody s hodnotou null nebo undefined jako this způsobí TypeError.
Jde o metodu standardní knihovny ECMAScript, nikoli o Web API. Podporu v konkrétním prohlížeči je nutné ověřit zvlášť; dostupnost v Node 24 nedokazuje podporu v prohlížečích.
Pří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ýsledek
true false false true TypeError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.