CKTIS / JavaScript
String.prototype.indexOf — wyszukiwanie podciągu
String.prototype.indexOf zwraca indeks pierwszego wystąpienia podciągu od pozycji początkowej wyznaczonej po konwersji i ograniczeniu argumentu position albo -1, jeśli nie ma dopasowania. Rozróżnia wielkość liter i liczy indeksy w jednostkach kodowych UTF-16.
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
string.indexOf(searchString)
string.indexOf(searchString, position)String.prototype.indexOf wyszukuje dosłowny podciąg bez zmieniania tekstu. Wyszukiwanie zaczyna się od pozycji wyznaczonej po konwersji i ograniczeniu position. Metoda zwraca indeks pierwszego dopasowania albo -1, jeśli go nie ma. Indeksy zaczynają się od 0 i oznaczają jednostki kodowe UTF-16, a nie zawsze całe znaki widoczne na ekranie. Wielkość liter ma znaczenie.
Argument position jest opcjonalny i domyślnie wynosi 0. Jest konwertowany na liczbę całkowitą przez obcięcie części ułamkowej w kierunku zera, a następnie ograniczany do przedziału od 0 do długości tekstu. NaN oznacza 0. Jeśli konwersja position się powiedzie, dla pustego searchString metoda zwraca tak wyznaczoną pozycję, nawet gdy jest to koniec tekstu. Przekazanie 0n jako position powoduje zgłoszenie wyjątku TypeError jeszcze przed wyszukiwaniem.
searchString jest konwertowany na tekst; pominięty argument oznacza wyszukiwanie "undefined". Metoda nie interpretuje wyrażeń regularnych — przekazany obiekt RegExp również zostanie przekonwertowany na tekst.
Obecność podciągu sprawdzaj przez result !== -1, nie przez if (result): indeks 0 jest fałszywy logicznie, a -1 prawdziwy. W przykładzie position zmienia początek wyszukiwania, lecz zwrócony indeks nadal odnosi się do całego tekstu.
Przykłady
const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);Wynik
1 3 -1 6 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.