CKTIS / JavaScript
Flag delle espressioni regolari: dotAll (`s`), `u`, `i` e `g`
I flag `s`, `u`, `i` e `g` controllano rispettivamente il punto in presenza di nuove righe, la modalità Unicode, la distinzione tra maiuscole e minuscole e la ricerca globale.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndexScrivi i flag dopo la barra di chiusura di un letterale (/a.b/gsui) oppure nel secondo argomento del costruttore (new RegExp("a.b", "gsui")). L’ordine è irrilevante; un flag sconosciuto o ripetuto causa un SyntaxError. Le proprietà dotAll, unicode, ignoreCase e global indicano se sono attivi rispettivamente s, u, i e g; non li modificano. Queste regole valgono in ECMAScript 2024, ma il supporto dipende dall’ambiente di esecuzione.
Con s (dotAll), il metacarattere . corrisponde anche ai quattro terminatori di riga: \n, \r, U+2028 e U+2029. Gli ancoraggi ^ e $ non cambiano; è m che permette loro di corrispondere anche ai limiti delle righe. Il punto con escape \. resta letterale.
u abilita la modalità Unicode: il punto tratta una coppia di surrogati valida come 😄 come un solo punto di codice anziché due unità UTF-16. Un punto di codice non è necessariamente un grafema intero, cioè un carattere percepito come unità. u impone anche una sintassi più rigorosa e non è combinabile con v (SyntaxError). i ignora le differenze tra maiuscole e minuscole; insieme a u usa il case folding semplice di Unicode, indipendente dalle impostazioni locali e senza espandere ß in ss.
g permette di scorrere le corrispondenze non sovrapposte. Con g e senza y, il metodo integrato exec() usa lastIndex come indice in unità UTF-16 per determinare dove iniziare la ricerca. In modalità Unicode, se quell’indice cade all’interno di una coppia di surrogati valida, una corrispondenza può iniziare all’inizio della coppia, prima di lastIndex. In caso di successo, exec() salva in lastIndex la posizione finale della corrispondenza in unità UTF-16; in caso di insuccesso, lo azzera. Anche test() può modificare questo stato: per una ricerca indipendente, azzera lastIndex o usa un nuovo RegExp. Una corrispondenza vuota può bloccare un ciclo con exec(). String.prototype.matchAll() richiede g per un argomento RegExp (altrimenti TypeError), avanza dopo le corrispondenze vuote e itera su una copia il cui lastIndex è inizializzato con il valore corrente di quello dell’originale.
Esempi
{
const text = "a\nb A😄b";
const re = /a.b/gsui;
const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);
console.log(JSON.stringify(collect(re)));
console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));
const positions = [];
for (let n = 0; n < 3; n++) {
re.exec(text);
positions.push(re.lastIndex);
}
console.log(JSON.stringify(positions));
}Risultato
["a\nb","A😄b"] [["A😄b"],["a\nb"],["a\nb"]] [3,8,0]
La prima riga mostra entrambe le corrispondenze. Nella seconda si tolgono, a turno e sempre dall’insieme completo, `s`, `u` e `i`: scompare la corrispondenza che attraversa la nuova riga, quella con l’emoji o quella con la maiuscola. La terza riga mostra `lastIndex` dopo due corrispondenze e un insuccesso.
Lezioni correlate
- JavaScript · Lezione 10 · Avanzato · Versione: 4