CKTIS / JavaScript
String.prototype.match — corrispondenze di espressioni regolari
Il metodo match() cerca in una stringa le corrispondenze di un’espressione regolare. Il flag g cambia la forma del risultato: senza il flag ottieni al massimo una corrispondenza con i gruppi di cattura; con il flag ottieni un array di corrispondenze complete. Se non ci sono corrispondenze, restituisce null.
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
string.match(regexp)String.prototype.match cerca le corrispondenze di un modello in una stringa senza modificarla. Con un oggetto RegExp standard, il risultato è un array oppure null se non trova corrispondenze. Prima di accedere agli elementi del risultato, controlla che non sia null.
Se non è impostato né g né y, il metodo restituisce la prima corrispondenza, se esiste. Con y ma senza g, cerca una corrispondenza che inizi esattamente nella posizione ottenuta applicando ToLength al valore corrente di lastIndex. Può quindi restituire una corrispondenza successiva oppure null anche se il modello trova una corrispondenza in un altro punto della stringa. Ad esempio, se lastIndex vale -1 per /a/y, il modello trova una corrispondenza all’indice 0 in 'a'. Se trova una corrispondenza senza g, l’elemento 0 contiene la corrispondenza completa e gli elementi successivi contengono i gruppi di cattura. La proprietà index indica la posizione della corrispondenza in unità di codice UTF-16, mentre input contiene la stringa cercata. Con g, l’array contiene corrispondenze complete che non si sovrappongono, ma non include i gruppi di cattura né questi metadati. Senza y, la ricerca può saltare i tratti della stringa che separano le corrispondenze. Con g e y insieme, la ricerca si ferma non appena il modello non trova una corrispondenza nella posizione corrente. Ad esempio, 'a a'.match(/a/gy) restituisce solo ['a'], anche se all’indice 2 c’è un’altra a. Per mantenere i gruppi di più corrispondenze, usa matchAll().
Un argomento stringa viene interpretato come modello di un’espressione regolare, non come testo letterale: "abc".match(".")[0] produce "a". Omettere l’argomento o passare undefined crea un modello vuoto, quindi il risultato è una corrispondenza con la stringa vuota, non null.
Tecnicamente, il metodo delega a Symbol.match se l’argomento fornisce tale metodo. Un’implementazione personalizzata può quindi restituire un tipo di risultato diverso; il comportamento con array descritto sopra si riferisce al comportamento standard di RegExp.
Esempi
const text = "item-12 item-34";
const first = text.match(/item-(\d+)/);
console.log(JSON.stringify([first[0], first[1], first.index]));
console.log(JSON.stringify(text.match(/item-(\d+)/g)));
console.log(text.match(/missing/g));Risultato
["item-12","12",0] ["item-12","item-34"] null
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.