Método match() da String do JavaScript

Definição e uso

match() O método faz correspondência de string com expressão regular.

Dica:Se o valor de busca for uma string, converta em expressão regular.

match() O método retorna um array contendo correspondências.

Se não encontrar correspondências, então match() O método retorna null.

Veja também:

Tutorial de expressão regular

Manual de referência de expressão regular

Diferença entre String match() e String search()

match() O método retorna o array de correspondências.

search() O método retorna a posição da primeira correspondência.

Exemplo

Exemplo 1

Busca usando string "ain":

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

Experimente você mesmo

Exemplo 2

Busca usando expressão regular "ain":

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

Experimente você mesmo

Exemplo 3

Busca global para "ain":

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

Experimente você mesmo

Exemplo 4

Busca global, insensível a maiúsculas e minúsculas:

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

Experimente você mesmo

Sintaxe

string.match(regexp)

Parâmetro

Parâmetro Descrição
regexp

Obrigatório. Valor de busca.

Expressão regular (ou será convertida em expressão regular, string).

Retorno

Tipo Descrição
Array ou null

Array contendo correspondências.

Se não encontrar correspondências, retorna null.

Detalhes técnicos

Parâmetro regexp

Este parâmetro especifica o objeto RegExp do padrão a ser correspondido. Se este parâmetro não for um objeto RegExp, ele será passado primeiro para o construtor RegExp(), convertendo-o em um objeto RegExp.

Retorno

Array de armazenamento de resultados de correspondência. O conteúdo do array depende de regexp de texto correspondido. gSe tiver o sinalizador global

. A seguir, detalha o valor de retorno.

match() Descrição stringO método buscará a string regexp para encontrar um ou mais regexp de texto correspondido. O comportamento deste método depende em grande parte de g.

Se regexp Se tiver o sinalizador match() Se o método não tiver o sinalizador g, então string Se não encontrar nenhum texto correspondido,match() Será retornado null. Caso contrário, ele retornará um array, contendo informações relacionadas ao texto correspondido que ele encontrou. O primeiro elemento do array contém o texto correspondido, e os outros elementos contêm o texto correspondido pelas subexpressões da expressão regular. Além desses elementos de array comuns, o array retornado também contém duas propriedades de objeto. A propriedade index declara a posição do caractere inicial do texto correspondido dentro string A propriedade input declara a posição dentro string da referência.

Se regexp com o sinalizador gentão match() O método executará a busca global, encontrando string Todas as subcadeias de correspondência dentro. Se não encontrar nenhuma subcadeia de correspondência, retornará null. Se encontrar uma ou mais subcadeias de correspondência, retornará um array. No entanto, o conteúdo do array retornado pela correspondência global é muito diferente do anterior, seus elementos de array contêm string Todas as subcadeias de correspondência dentro, e não têm atributos index ou input.

Atenção:No modo de busca global,match() Não fornece informações sobre o texto correspondido pelos subexpressões nem declara a posição de cada subcadeia de correspondência. Se você precisar dessas informações de busca global, você pode usar RegExp.exec().

Métodos de busca de expressão regular

No JavaScript, a busca de texto de expressão regular pode ser feita de diferentes maneiras.

Esses são os métodos mais comuns, usando o padrão como expressão regular:

Exemplo Descrição
text.match(padrão) Método match() de string
text.search(padrão) Método search() de string
padrão.exec(text) Método exec() de expressão regular
padrão.test(text) Método test() de expressão regular

Suporte do navegador

match() É uma característica do ECMAScript1 (ES1).

Todos os navegadores suportam completamente ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

String do JavaScript

Métodos da String do JavaScript

Pesquisa de String do JavaScript