CKTIS / JavaScript
String.prototype.includes — sprawdzanie obecności podciągu
String.prototype.includes sprawdza, czy tekst zawiera podany podciąg, i zwraca true albo false. Rozróżnia wielkość liter, pozwala wskazać początek wyszukiwania i nie przyjmuje zwykłych wyrażeń regularnych.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
str.includes(searchString)
str.includes(searchString, position)String.prototype.includes wyszukuje dosłowny podciąg i zwraca true albo false, bez zmiany tekstu. Rozróżnia wielkość liter i porównuje jednostki kodowe UTF-16: nie normalizuje Unicode ani nie stosuje reguł językowych.
Opcjonalne position określa najwcześniejszy indeks początku dopasowania, liczony od zera w jednostkach kodowych UTF-16. Domyślnie wynosi 0; po konwersji na liczbę część ułamkowa jest odrzucana w kierunku zera, a wynik ograniczany do zakresu od 0 do długości tekstu. Jeśli metoda dojdzie do etapu dopasowania, dla pustego searchString zwróci true, nawet gdy podana pozycja przekracza długość tekstu. Konwersja position odbywa się jednak przed dopasowaniem: wartość typu BigInt jako position powoduje TypeError nawet przy pustym searchString.
Zwykły obiekt RegExp jako searchString powoduje TypeError; formalnie decyduje test IsRegExp, uwzględniający Symbol.match. Pozostałe argumenty wyszukiwania podlegają konwersji na tekst, więc pominięty argument oznacza szukanie "undefined". Wywołanie metody z null lub undefined jako this powoduje TypeError.
To metoda standardowej biblioteki ECMAScript, nie Web API. Zgodność konkretnej przeglądarki należy sprawdzić osobno; obecność metody w Node 24 jej nie dowodzi.
Przykłady
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);
}Wynik
true false false true TypeError
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.