CKTIS / JavaScript
RegExp lastIndex — položaj sljedećeg podudaranja
lastIndex pohranjuje sljedeći položaj pretraživanja za regularne izraze sa zastavicom g ili y. To je zapisivo svojstvo svake instance RegExp, a ne svojstvo prototipa.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
regexp.lastIndex
regexp.lastIndex = indexUnatoč nazivu RegExp.prototype.lastIndex, lastIndex vlastito je svojstvo svake instance RegExp i početna mu je vrijednost 0. Može se mijenjati, nije nabrojivo ni konfigurabilno. Položaji se broje u UTF-16 kodnim jedinicama, a ne u znakovima koje korisnik doživljava kao cjelinu.
Kod ugrađenih metoda exec() i test() lastIndex je polazište pretraživanja sa zastavicom g ili y. Uz g bez y podudaranje može početi na kasnijem položaju; uz y kasniji se položaji ne provjeravaju. Ako u načinu rada Unicode (u ili v) lastIndex pokazuje na donju zamjensku jedinicu valjanog para UTF-16, podudaranje uz y može početi na prethodnoj gornjoj zamjenskoj jedinici. Uspjeh postavlja indeks odmah iza podudaranja; neuspjeh ga vraća na nulu, čak i ako prelazi duljinu niza. Čak i kad nije postavljena nijedna od tih zastavica, ugrađeni algoritam pretraživanja očitava lastIndex i na njegovu vrijednost primjenjuje operaciju ToLength. Ako pretvorba uspije, algoritam započinje pretraživanje od 0 i ne ažurira svojstvo. Ako je vrijednost tipa Symbol, pretvorba izaziva iznimku TypeError i pretraživanje ne počinje.
Možeš dodijeliti regexp.lastIndex = index; pri uporabi vrijednost se pretvara pomoću ToLength. Stanje pripada izrazu, a ne nizu: prije neovisnog pretraživanja postavi lastIndex = 0 ili stvori drugu instancu. I ponovljeni pozivi test() sa zastavicom g ili y mijenjaju stanje.
Prazno podudaranje u exec() ne pomiče indeks automatski, pa naivna petlja možda nikad neće završiti. Primjer koristi neprazna podudaranja i prikazuje napredovanje, vraćanje na nulu nakon neuspjeha i ručni nastavak.
Primjeri
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);Rezultat
true 1 true 3 false 0 2 3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.