Método match

O método match retorna um array de correspondências com uma expressão regular. Se não houver correspondências, retornará null. Quando chamado sem o modificador g, o método retorna um array, no qual o elemento zero conterá a substring encontrada, e os demais elementos - os grupos de captura. Se o método for chamado com o modificador g, ele retorna todas as correspondências encontradas na forma de um array.

Sintaxe

javascriptstring.match(expressão regular);

Exemplo

Vamos encontrar uma correspondência com uma expressão regular e decompô-la em grupos de captura:

javascriptlet str = '12:34';
let res = str.match(/(\d+):(\d+)/);

console.log(res[0]); // o que foi encontrado
console.log(res[1]); // Grupo 1
console.log(res[2]); // Grupo 2

Resultado da execução do código:

javascript'12:34'
'12'
'34'

Exemplo

Vamos obter um array de substrings consistindo da letra 'a':

javascriptlet str = 'a aa aaa aaaa';
let res = str.match(/a+/g);

console.log(res);

Resultado da execução do código:

javascript['a', 'aa', 'aaa', 'aaaa']

Veja também

  • método test,
    que verifica uma string
  • método matchAll,
    que busca todas as correspondências em uma string
  • método exec,
    que executa uma busca sequencial
  • método replace,
    que executa busca e substituição
  • método search,
    que executa uma busca
  • método split,
    que divide uma string