CKTIS / JavaScript
RegExp lastIndex — posizione della corrispondenza successiva
lastIndex memorizza la posizione di ricerca successiva per le espressioni regolari con il flag g o y. È una proprietà modificabile di ogni istanza RegExp, non una proprietà del prototipo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
regexp.lastIndex
regexp.lastIndex = indexNonostante il nome RegExp.prototype.lastIndex, lastIndex è una proprietà propria di ogni istanza di RegExp e inizialmente vale 0. È modificabile, non enumerabile e non configurabile. Le posizioni si contano in unità di codice UTF-16, non in caratteri percepiti dall’utente.
Con i metodi integrati exec() e test(), lastIndex è il punto di partenza della ricerca quando è attivo il flag g o y. Con g senza y, la ricerca può trovare una corrispondenza in una posizione successiva; con y non vengono provate posizioni successive. In modalità Unicode (u o v), se lastIndex punta al surrogato basso di una coppia di surrogati UTF-16 valida, una corrispondenza con y può iniziare dal surrogato alto che lo precede. In caso di successo, l’indice viene impostato subito dopo la corrispondenza; in caso di insuccesso viene azzerato, anche se supera la lunghezza della stringa. Anche in assenza di entrambi i flag, l’algoritmo di ricerca integrato legge lastIndex e applica ToLength al suo valore. Se la conversione riesce, l’algoritmo avvia la ricerca da 0 e non aggiorna la proprietà. Se il valore è un Symbol, la conversione genera un’eccezione TypeError e la ricerca non inizia.
Puoi assegnare regexp.lastIndex = index; quando viene usato, il valore è convertito con ToLength. Lo stato appartiene all’espressione, non alla stringa: imposta lastIndex = 0 oppure crea un’altra istanza prima di una ricerca indipendente. Anche le chiamate ripetute a test() con g o y modificano lo stato.
Una corrispondenza vuota in exec() non fa avanzare automaticamente l’indice, quindi un ciclo ingenuo può non terminare mai. L’esempio usa corrispondenze non vuote e mostra l’avanzamento, l’azzeramento dopo un insuccesso e la ripresa manuale.
Esempi
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);Risultato
true 1 true 3 false 0 2 3
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.