Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

RegExp lastIndex — položaj naslednjega ujemanja

lastIndex shranjuje naslednji položaj iskanja za regularne izraze z zastavico g ali y. Je zapisljiva lastnost vsake instance RegExp, ne lastnost prototipa.

Različica: 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 = index

Kljub oznaki RegExp.prototype.lastIndex je lastIndex lastna lastnost vsake instance RegExp in je na začetku enaka 0. Je zapisljiva, neštevna in nekonfigurabilna. Položaji se štejejo v kodnih enotah UTF-16, ne v znakih, kot jih zaznava uporabnik.

Pri vgrajenih metodah exec() in test() je lastIndex izhodiščni položaj iskanja z zastavico g ali y. Z zastavico g brez y se lahko ujemanje začne tudi na poznejšem položaju; z zastavico y se poznejši položaji ne preverjajo. Če v načinu Unicode (u ali v) lastIndex kaže na nizki nadomestek veljavnega nadomestnega para UTF-16, se lahko ujemanje z zastavico y začne pri visokem nadomestku, ki je tik pred njim. Ob uspehu se indeks nastavi neposredno za ujemanjem; ob neuspehu se ponastavi na nič, tudi če presega dolžino niza. Tudi če ni nastavljena nobena od teh dveh zastavic, vgrajeni iskalni algoritem prebere lastIndex in na njegovi vrednosti izvede operacijo ToLength. Če pretvorba uspe, algoritem začne iskati pri 0 in lastnosti ne posodobi. Če je vrednost tipa Symbol, pretvorba sproži izjemo TypeError in iskanje se ne začne.

Dodeliš lahko regexp.lastIndex = index; ob uporabi se vrednost pretvori z ToLength. Stanje pripada izrazu, ne nizu: pred neodvisnim iskanjem nastavi lastIndex = 0 ali ustvari drugo instanco. Tudi ponavljajoči se klici test() z zastavico g ali y spremenijo stanje.

Prazno ujemanje v exec() indeksa ne poveča samodejno, zato se naivna zanka morda nikoli ne konča. Primer uporablja neprazna ujemanja ter pokaže napredovanje, ponastavitev po neuspehu in ročno nadaljevanje.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri