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 = indexMimo 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.