Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Gruppi di cattura con nome in RegExp e sostituzioni nel testo di rimpiazzo

Leggi il testo catturato per nome e riutilizzalo in una stringa o in una funzione di sostituzione, anche quando un gruppo è facoltativo.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

/(?<name>pattern)/
/(?<name>pattern)\k<name>/
regexp.exec(text)?.groups?.name
text.replace(regexp, "$<name>")
text.replace(regexp, replacer)
text.replaceAll(globalRegexp, replacement)
Replacement string tokens: $$, $&, $`, $', $1 … $99, $<name>

(?<name>...) cattura il testo che corrisponde a un sottopattern. I gruppi con e senza nome sono numerati insieme a partire da 1, nell’ordine delle parentesi di apertura; (?:...) non cattura. Dopo un exec() riuscito, il valore si legge con result.groups.name; se il gruppo non ha partecipato alla corrispondenza, vale undefined. Nel pattern, \k<name> è un riferimento all’indietro che serve a riconoscere il testo catturato, non a inserirlo nel risultato della sostituzione.

In una stringa di sostituzione, $<name> inserisce una cattura con nome, $1 la prima cattura, $& l’intera corrispondenza e $$ un simbolo di dollaro. $` e $' inseriscono rispettivamente il testo originale prima e dopo la corrispondenza. Se il pattern contiene gruppi con nome, un nome sconosciuto o un gruppo che non ha partecipato produce una stringa vuota. Senza gruppi con nome, $<name> resta letterale. Anche un gruppo numerato esistente che non ha partecipato produce una stringa vuota; se il gruppo 12 non esiste, $12 può indicare $1 seguito da un 2 letterale, purché esista il gruppo 1.

La funzione di sostituzione riceve l’intera corrispondenza, i valori delle catture nell’ordine, la posizione in unità di codice UTF-16, la stringa di input e, solo se il pattern ha gruppi con nome, un oggetto groups come ultimo argomento. Le catture che non hanno partecipato valgono undefined. Il risultato della funzione non viene interpretato come modello di sostituzione: usa () => text per inserire letteralmente testo contenente $.

Con una RegExp standard, replace() sostituisce solo la prima corrispondenza se non è presente né g né y, e tutte le corrispondenze con g senza y. Con y senza g, sostituisce al massimo una corrispondenza, che deve iniziare nella posizione indicata dal valore corrente di lastIndex. Con gy, parte dalla posizione 0 e si ferma non appena non trova una corrispondenza nella posizione corrente, senza cercare oltre. replaceAll() genera un TypeError se l’espressione regolare non ha g. Entrambi i metodi restituiscono una stringa senza modificare l’input.

I nomi dei gruppi seguono la sintassi degli identificatori. Un nome non valido genera un SyntaxError, come anche qualsiasi nome duplicato in ECMAScript 2024. ECMAScript 2025 ammette lo stesso nome in rami distinti della stessa disgiunzione |. Verifica il supporto nell’ambiente di esecuzione di destinazione e usa nomi univoci per la compatibilità con ECMAScript 2024.

Esempi

const text = "AB-12 CD";
const token = /(?<code>[A-Z]{2})(?:-(?<number>\d+))?/g;

console.log(text.replace(token, "[$<code>:$<number>]"));
console.log(text.replace(token, (match, code, number, offset, input, groups) =>
  `[${groups.code}:${groups.number ?? "none"}]`
));

Risultato

[AB:12] [CD:]
[AB:12] [CD:none]

Per `CD`, il gruppo `number` non partecipa. La stringa di sostituzione lascia vuoto il campo, mentre la funzione inserisce `none`.

Lezioni correlate

  • JavaScript · Lezione 25 · Intermedio · Versione: 3

Fonti