CKTIS / JavaScript
RegExp — espressioni regolari
RegExp descrive schemi per cercare nel testo. Scopri flag, gruppi, classi di caratteri, quantificatori e campi del risultato di exec(), comprese le catture con nome, gli intervalli di indici e il comportamento con stato di lastIndex.
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
/pattern/flags; new RegExp("pattern", "flags"); regexp.exec(text); regexp.test(text)RegExp rappresenta uno schema testuale. Crealo con /pattern/flags oppure new RegExp("pattern", "flags"); le stringhe del costruttore richiedono un livello aggiuntivo di escape delle barre rovesciate: /\d+/ corrisponde a new RegExp("\\d+"). test() restituisce un booleano; exec() restituisce un array di corrispondenza o null. Questa voce tratta i flag RegExp, i gruppi, le classi, i quantificatori e i campi del risultato.
Flag: g abilita le corrispondenze successive, i ignora maiuscole e minuscole, m fa riconoscere a ^ e $ i confini di riga, s consente a . di corrispondere ai terminatori di riga, u abilita la modalità Unicode, v la estende con operazioni sugli insiemi di caratteri, y richiede una corrispondenza esattamente in lastIndex e d aggiunge intervalli di indici. u e v si escludono a vicenda; flag duplicati o sconosciuti causano un SyntaxError.
Classi come [a-z], [^0-9] e \d selezionano caratteri; \d indica le cifre ASCII. I gruppi (…) catturano testo, (?<name>…) assegna un nome a una cattura e (?:…) non cattura. I quantificatori *, +, ? e {n,m} significano rispettivamente zero o più, uno o più, zero o uno e da n a m ripetizioni. Per impostazione predefinita sono avidi; un ? finale li rende pigri.
Un risultato di exec() contiene la corrispondenza completa in [0], le catture da [1] in poi, la posizione iniziale in index, il testo originale in input e le catture con nome in groups, oppure undefined se non ci sono gruppi con nome. Le catture senza corrispondenza valgono undefined. Solo con il flag d l’array di corrispondenza contiene un array indices: indices[0] è la coppia di indici della corrispondenza completa e gli elementi successivi contengono le coppie delle rispettive catture o undefined per quelle che non hanno partecipato alla corrispondenza. Ogni coppia delimita un intervallo [start,end) (estremo finale escluso) misurato in unità di codice UTF-16, come index e lastIndex. Se lo schema non contiene catture con nome, indices.groups vale undefined. Altrimenti è un oggetto che associa a ciascun nome di cattura la relativa coppia di indici o undefined se quella cattura non ha partecipato alla corrispondenza.
Con g o y, sia exec() sia test() modificano lastIndex: in caso di successo viene impostato alla fine della corrispondenza; in caso di insuccesso viene azzerato. Una corrispondenza vuota non lo incrementa automaticamente in exec(), quindi un ciclo potrebbe non terminare. I gruppi con nome sono di ES2018, d di ES2022 e v di ES2024. Sono funzionalità ECMAScript, non API Web; verifica il supporto nel browser di destinazione indipendentemente da Node 24 nel repository.
Esempi
const re = /(?<key>[a-z]+)=(\d{2})/dg;
const text = "id=42";
const m = re.exec(text);
if (m === null) throw new Error("Expected a match");
console.log(JSON.stringify({
match: m[0],
captures: [m[1], m[2]],
key: m.groups.key,
index: m.index,
input: m.input,
span: m.indices[0],
keySpan: m.indices.groups.key,
lastIndex: re.lastIndex
}));Risultato
{"match":"id=42","captures":["id","42"],"key":"id","index":0,"input":"id=42","span":[0,5],"keySpan":[0,2],"lastIndex":5}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.