Metodo match() della stringa JavaScript

Definizione e uso

match() Il metodo abbinisce una stringa a un'espressione regolare.

Suggerimento:Se il valore di ricerca è una stringa, viene convertito in un'espressione regolare.

match() Il metodo restituisce un array che contiene le corrispondenze.

Se non viene trovata alcuna corrispondenza, viene restituito match() Il metodo restituisce null.

Vedi anche:

Tutorial sulle espressioni regolari

Manuale di riferimento delle espressioni regolari

Differenza tra String match() e String search()

match() Il metodo restituisce l'array delle corrispondenze.

search() Il metodo restituisce la posizione della prima corrispondenza.

Esempio

Esempio 1

Ricerca di "ain" utilizzando una stringa:

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Prova tu stesso

Esempio 2

Ricerca di "ain" utilizzando un'espressione regolare:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Prova tu stesso

Esempio 3

Ricerca globale di "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Prova tu stesso

Esempio 4

Ricerca globale, insensibile alle maiuscole e minuscole:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Prova tu stesso

Sintassi

string.match(regexp)

Parametro

Parametro Descrizione
regexp

Obbligatorio. Valore di ricerca.

Espressione regolare (o verrà convertita in un'espressione regolare la stringa).

Valore di ritorno

Tipo Descrizione
Array o null

Array che contiene le corrispondenze.

Se non viene trovata alcuna corrispondenza, viene restituito null.

Dettagli tecnici

Parametro regexp

Questo parametro specifica l'oggetto RegExp da abbinare. Se questo parametro non è un oggetto RegExp, viene prima passato al costruttore RegExp() e convertito in un oggetto RegExp.

Valore di ritorno

L'array che contiene i risultati delle corrispondenze. Il contenuto dell'array dipende da regexp ha il flag globale gse

Di seguito si spiega in dettaglio il valore di ritorno.

match() Descrizione stringIl metodo cercherà la stringa regexp per trovare una o più corrispondenze con regexp se g.

Se regexp senza il flag g, allora match() Il metodo può essere eseguito solo string Se non è stato trovato alcun testo corrispondente,match() verrà restituito null. Altrimenti, restituirà un array che contiene informazioni relative al testo corrispondente trovato. L'elemento zero dell'array contiene il testo corrispondente, e gli altri elementi contengono il testo che corrisponde agli espressioni regolari di sottoespressione. Oltre agli elementi dell'array regolari, l'array restituito contiene anche due proprietà oggetto. L'attributo index dichiara la posizione del carattere di inizio del testo corrispondente all'interno string La posizione all'interno, l'attributo input dichiara che è per string del riferimento.

Se regexp con il flag gse match() Il metodo esegue la ricerca globale, trova string Tutte le sottoespressioni corrispondenti all'interno. Se non è stato trovato alcun sottoespressione corrispondente, viene restituito null. Se è stato trovato uno o più sottoespressioni corrispondenti, viene restituito un array. Tuttavia, il contenuto dell'array restituito dalla ricerca globale è molto diverso da quello precedente, il suo elemento dell'array contiene string Tutte le sottoespressioni corrispondenti all'interno, e non hanno né l'attributo index né l'attributo input.

Attenzione:In modalità di ricerca globale,match() Non fornisce informazioni sul testo che corrisponde agli espressioni regolari di sottoespressione né dichiara la posizione di ogni sottoespressione corrispondente. Se hai bisogno di queste informazioni di ricerca globale, puoi utilizzare RegExp.exec().

Metodi di ricerca con espressioni regolari

In JavaScript, la ricerca di testo con espressioni regolari può essere completata in diversi modi.

Questi sono i metodi più comuni utilizzando il modello come espressione regolare:

Esempio Descrizione
text.match(pattern) Metodo match() della stringa
text.search(pattern) Metodo search() della stringa
pattern.exec(text) Metodo exec() dell'espressione regolare
pattern.test(text) Metodo test() dell'espressione regolare

Supporto dei browser

match() Sono caratteristiche di ECMAScript1 (ES1).

Tutti i browser supportano completamente ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Supporto Supporto Supporto Supporto Supporto Supporto

Pagine correlate

Stringa JavaScript

Metodi della stringa JavaScript

Ricerca delle stringhe JavaScript