match() String JavaScript

Aqui você aprenderá o método match() para comparar uma string com uma expressão regular.

English version: https://www.javascripttutorial.net/javascript-string-match/

Para entender como o método JavaScript String match() e como usá-lo de forma eficiente, você deve ter conhecimento básico sobre expressões regulares. Caso você precise, pode consultar o tutorial básico de expressão regular no link abaixo:

Expressão Regular no JavaScript JavaScript

Introdução ao método JavaScript match()

O método String match() compara uma string com uma expressão regular:

Se o argumento regexp não for uma expressão regular, o match() fará a conversão em uma expressão regular usando o construtor RegExp().

Get Ricardo Reis’s stories in your inbox

Join Medium for free to get updates from this writer.

Remember me for faster sign in

O match() retorna um array inde se a expressão regular usar o marcador global g ou não:

• Se o regexp usa o marcador g, o método match() retorna um array que armazena todos os resultados correspondentes. O resultado não contém os grupos de captura.
• Se o regexp não usar o marcador g, o match() retornará a primeira correspondência e seu grupo de captura relacionado. O resultado da correspondência é o mesmo resultado que RegExp.exec() com propriedades adicionais. Veja jo exemplo abaixo para os detalhes.

O match() retorna null se não encontrar nenhuma correspondência.

Método JavaScript String match()

Vamos dar alguns exemplos de uso do método match().

1) O método match() com a expressão que possui o marcador global

O exemplo a seguir mostra como usar o método match() com o marcador global g. Ele retorna um array de correspondências:

Resultado:

Neste exemplo, o match() procura por qualquer número que tenha o sinal $ antes dele.

2) O método match() a expressão que sem o marcador global

O exemplo a seguir ilustra como usar o método match() com uma expressão regular que não possui o marcador global g. Ele retorna um array da primeira correspondência com propriedades adicionais.

Resultado:

As propriedades adicionais são:

• index: É o índice no qual a correspondência foi encontrada.
• input: Uma cópia da string pesquisada.
• groups: É o objeto de grupos de captura nomeados cujas chaves e valores são os nomes e os grupos de captura respectivamente. Neste exemplo, é undefined porque não definimos quaisquer grupos de captura nomeados.

3) O método match com o grupo de captura nomeado

O seguinte código mostra como usar o método match() com o grupo de captura nomeado. Ele captura o yellow em um grupo denominado color:

Resultado:

Neste tutorial você aprendeu como usar o método match() de String JavaScript para comparar uma string com uma expressão regular.

Veja o índice de todos os tutoriais JavaScript

Confira uma série de outros tutoriais JavaScript que eu escrevi, clicando no link abaixo:

Tutoriais JavaScript