CKTIS / JavaScript
RegExp lastIndex — pozícia ďalšej zhody
lastIndex uchováva ďalšiu pozíciu hľadania pre regulárne výrazy s príznakom g alebo y. Je to zapisovateľná vlastnosť každej inštancie RegExp, nie vlastnosť prototypu.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
regexp.lastIndex
regexp.lastIndex = indexNapriek názvu RegExp.prototype.lastIndex je lastIndex vlastnou vlastnosťou každej inštancie RegExp a jej počiatočná hodnota je 0. Je zapisovateľná, nevymenovateľná a nekonfigurovateľná. Pozície sa počítajú v jednotkách kódu UTF-16, nie v znakoch vnímaných používateľom.
Pri vstavaných metódach exec() a test() je pri použití príznaku g alebo y východiskovou pozíciou hľadania lastIndex. S príznakom g bez y môže zhoda začínať aj na neskoršej pozícii; s príznakom y sa neskoršie pozície neskúšajú. Ak v režime Unicode (u alebo v) ukazuje lastIndex na dolnú náhradnú jednotku platného páru UTF-16, zhoda s príznakom y sa môže začať na predchádzajúcej hornej náhradnej jednotke. Pri úspechu sa index nastaví hneď za zhodu; pri neúspechu sa vynuluje, aj keď presahuje dĺžku reťazca. Aj keď nie je nastavený ani jeden z týchto príznakov, vstavaný vyhľadávací algoritmus načíta lastIndex a na jeho hodnotu použije operáciu ToLength. Ak sa prevod podarí, algoritmus začne hľadať od 0 a vlastnosť neaktualizuje. Ak je hodnota typu Symbol, prevod vyvolá výnimku TypeError a hľadanie sa nezačne.
Môžeš priradiť regexp.lastIndex = index; pri použití sa hodnota prevedie pomocou ToLength. Stav patrí výrazu, nie reťazcu: pred nezávislým hľadaním nastav lastIndex = 0 alebo vytvor ďalšiu inštanciu. Opakované volania test() s príznakom g alebo y menia stav tiež.
Prázdna zhoda v exec() automaticky neposunie index, takže naivná slučka nemusí nikdy skončiť. Príklad používa neprázdne zhody a ukazuje postup, vynulovanie po neúspechu a ručné pokračovanie.
Prí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ýsledok
true 1 true 3 false 0 2 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tej presnej verzie.