Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.lastIndexOf — ostatnie wystąpienie podciągu

lastIndexOf() zwraca indeks ostatniego wystąpienia podciągu albo -1. Opcjonalny position ogranicza indeks początku dopasowania, a nie jego końca.

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.lastIndexOf(searchString[, position])

String.prototype.lastIndexOf wyszukuje podciąg, rozróżniając wielkość liter, i zwraca największy pasujący indeks liczony od zera albo -1. Nie zmienia napisu. Indeksy oznaczają jednostki kodowe UTF-16, niekoniecznie całe znaki widoczne dla użytkownika.

Opcjonalny position określa największy dozwolony indeks początku dopasowania; dopasowanie może kończyć się dalej. Pominięcie argumentu, undefined lub NaN pozwala przeszukać cały napis. Wartości ułamkowe są obcinane w kierunku zera, ujemne są ograniczane do 0, a zbyt duże nie rozszerzają wyszukiwania poza napis. Dlatego ujemny position nadal pozwala znaleźć dopasowanie zaczynające się od 0.

Pusty searchString pasuje na każdej granicy jednostek kodowych; bez position wynikiem jest długość napisu. searchString jest konwertowany na napis: pominięcie go oznacza wyszukiwanie "undefined". Metoda nie interpretuje wyrażeń regularnych.

W przykładzie "ana" zaczyna się pod indeksami 1 i 3. Używaj porównania !== -1 do sprawdzania obecności: indeks 0 jest poprawnym wynikiem, choć w warunku logicznym jest fałszywy.

Przykłady

const text = "banana";
console.log(text.lastIndexOf("ana"));
console.log(text.lastIndexOf("ana", 2));
console.log(text.lastIndexOf("x"));
console.log(text.lastIndexOf(""));
console.log(text.lastIndexOf("b", -1));

Wynik

3
1
-1
6
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła