CKTIS / JavaScript
RegExp.prototype.exec — corrispondenze e gruppi di cattura
RegExp.prototype.exec cerca una corrispondenza e restituisce un array contenente il testo corrispondente e le catture, oppure null. I flag g e y fanno sì che le chiamate successive usino lastIndex e ne aggiornino il valore.
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.exec(string)regexp.exec(string) esegue una ricerca con un’espressione regolare. L’argomento viene convertito in una stringa; il metodo integrato richiede che this sia una vera istanza di RegExp. Il risultato è un array oppure null, non un valore booleano. Controlla il risultato prima di leggerne le proprietà.
match[0] contiene la corrispondenza completa, mentre match[1] e gli elementi successivi contengono i gruppi di cattura. Un gruppo che non ha partecipato alla corrispondenza produce undefined. match.index è la posizione iniziale in unità di codice UTF-16, e match.input è la stringa in cui si esegue la ricerca. match.groups contiene i gruppi con nome, oppure undefined se il pattern non ne ha. Il flag d espone inoltre match.indices con coppie di inizio e fine; il limite finale è esclusivo.
Senza g né y, la ricerca inizia alla posizione 0 e lascia invariato lastIndex. Se è impostato almeno uno dei due flag, la ricerca usa come punto di partenza il risultato di ToLength applicato a lastIndex (ad esempio, 1.9 diventa 1). Con g ma senza y, la ricerca può provare posizioni successive dopo un tentativo fallito; con y, non lo fa. In modalità Unicode (u o v), se il valore convertito di lastIndex punta alla seconda unità di una coppia di surrogati UTF-16, una corrispondenza può iniziare alla prima unità della coppia. Quindi, anche con y, il valore restituito in match.index può differire dal valore convertito di lastIndex. Se la ricerca ha successo, lastIndex viene impostato alla fine della corrispondenza; se fallisce, viene azzerato. Prima di riutilizzare l’oggetto per una ricerca indipendente, imposta lastIndex = 0.
In un ciclo, mantieni lo stesso oggetto RegExp. Attenzione: una corrispondenza vuota non fa avanzare automaticamente lastIndex; senza un avanzamento esplicito o un’interruzione, il ciclo potrebbe non terminare mai. L’esempio usa un pattern che corrisponde sempre ad almeno un carattere e mostra l’azzeramento dopo il fallimento finale.
Esempi
const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);Risultato
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
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.