Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła