Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

RegExp lastIndex — pozice další shody

lastIndex uchovává další pozici hledání pro regulární výrazy s příznakem g nebo y. Jde o zapisovatelnou vlastnost každé instance RegExp, nikoli o vlastnost prototypu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.lastIndex
regexp.lastIndex = index

Navzdory názvu RegExp.prototype.lastIndex je lastIndex vlastní vlastností každé instance RegExp a její počáteční hodnota je 0. Je zapisovatelná, neenumerovatelná a nekonfigurovatelná. Pozice se počítají v jednotkách kódu UTF-16, nikoli ve znacích vnímaných uživatelem.

U vestavěných metod exec() a test() je při použití příznaku g nebo y výchozí pozicí hledání lastIndex. S příznakem g bez y může shoda začínat i na pozdější pozici; s příznakem y se pozdější pozice nezkoušejí. Pokud v režimu Unicode (u nebo v) ukazuje lastIndex na dolní náhradní jednotku platného páru UTF-16, může shoda s příznakem y začít u předcházející horní náhradní jednotky. Při úspěchu se index nastaví těsně za shodu; při neúspěchu se nastaví na nulu, i když překračuje délku řetězce. I bez obou příznaků vestavěný vyhledávací algoritmus načte lastIndex a použije na jeho hodnotu operaci ToLength. Pokud se převod podaří, algoritmus začne hledat od 0 a vlastnost neaktualizuje. Pokud je hodnota typu Symbol, převod vyvolá výjimku TypeError a hledání se vůbec nespustí.

Můžeš přiřadit regexp.lastIndex = index; při použití se hodnota převede pomocí ToLength. Stav patří výrazu, nikoli řetězci: před nezávislým hledáním nastav lastIndex = 0 nebo vytvoř další instanci. Opakovaná volání test() s příznakem g nebo y stav také mění.

Prázdná shoda v exec() index automaticky neposune, takže naivní smyčka nemusí nikdy skončit. Příklad používá neprázdné shody a ukazuje posun, vynulování po neúspěchu a ruční pokračování.

Příklady

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);

Výsledek

true 1
true 3
false 0
2 3

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje