Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

RegExp lastIndex — pozycja kolejnego dopasowania

lastIndex przechowuje pozycję następnego wyszukiwania dla wyrażeń z flagą g lub y. Jest zapisywalną właściwością instancji RegExp, a nie właściwością prototypu.

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

regexp.lastIndex
regexp.lastIndex = index

Mimo oznaczenia RegExp.prototype.lastIndex, lastIndex jest własną właściwością każdej instancji RegExp, początkowo równą 0. Jest zapisywalna, niewyliczalna i niekonfigurowalna. Pozycje liczone są w jednostkach kodowych UTF-16, nie w znakach widocznych dla użytkownika.

We wbudowanych exec() i test() pozycją wyjściową dla flag g i y jest lastIndex. Z flagą g bez y wyszukiwanie dopuszcza dopasowanie na późniejszej pozycji; z flagą y nie sprawdza późniejszych pozycji. W trybie Unicode (u lub v), jeśli lastIndex wskazuje młodszą jednostkę surogatową poprawnej pary UTF-16, dopasowanie z flagą y może zacząć się od poprzedzającej ją starszej jednostki surogatowej. Sukces ustawia indeks tuż za dopasowaniem, a niepowodzenie zeruje go, również gdy przekracza długość tekstu. Nawet bez flag g i y wbudowany algorytm dopasowywania odczytuje lastIndex i stosuje do tej wartości operację ToLength. Jeśli konwersja się powiedzie, algorytm rozpoczyna wyszukiwanie od 0 i nie aktualizuje właściwości. Jeśli lastIndex ma wartość typu Symbol, konwersja zgłasza TypeError, a wyszukiwanie się nie rozpoczyna.

Możesz przypisać regexp.lastIndex = index; przy użyciu wartość podlega konwersji ToLength. Stan należy do wyrażenia, nie tekstu: przed niezależnym wyszukiwaniem ustaw lastIndex = 0 albo utwórz nową instancję. Powtarzane test() z g lub y również zmienia stan.

Puste dopasowanie w exec() nie przesuwa automatycznie indeksu, więc naiwna pętla może nigdy się nie zakończyć. Przykład używa niepustych dopasowań i pokazuje postęp, wyzerowanie po porażce oraz ręczne wznowienie.

Przykłady

const re = /a/g;
const text = "a_a";
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
re.lastIndex = 2;
console.log(re.exec(text).index, re.lastIndex);

Wynik

true 1
true 3
false 0
2 3

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

Źródła