JavaScript String match()
Exemplos
Uma busca por "ain" usando uma string:
let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");
Uma busca por "ain" usando uma expressão regular:
let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);
Uma busca global por "ain":
let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);
Uma pesquisa global que não diferencia maiúsculas de minúsculas:
let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);
Definição e uso
O match()
método corresponde a uma string com uma expressão regular **
O match()
método retorna um array com as correspondências.
O match()
método retorna null se nenhuma correspondência for encontrada.
Observação
** Se o valor de pesquisa for uma string, ele será convertido em uma expressão regular.
Veja também:
Sintaxe
string.match(match)
Parâmetros
Parameter | Description |
match | Required. The search value. A regular expression (or a string that will be converted to a regular expression). |
Valores de retorno
Modelo | Descrição |
Uma matriz ou null | Uma matriz contendo as correspondências. null se nenhuma correspondência for encontrada. |
A diferença entre
String match() e String search()
O match()
método retorna uma matriz de correspondências.
O search()
método retorna a posição da primeira correspondência.
Métodos de pesquisa de expressões regulares
Em JavaScript, uma pesquisa de texto de expressão regular pode ser feita com diferentes métodos.
Com um padrão como uma expressão regular, estes são os métodos mais comuns:
Exemplo | Descrição |
---|---|
text.match( padrão ) | O método String match() |
text.search( padrão ) | O método String search() |
padrão .exec(texto) | O método RexExp exec() |
padrão .test(texto) | O método RegExp test() |
Suporte ao navegador
match()
é um recurso ECMAScript1 (ES1).
ES1 (JavaScript 1997) é totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |