Método matchAll

O método matchAll retorna todas as correspondências com uma expressão regular na forma de um objeto iterável, onde cada elemento contém um array com a correspondência encontrada e seus grupos de captura. O método só pode ser chamado com o modificador g. Se não houver correspondências, retornará null.

Sintaxe

javascriptstring.matchAll(expressãoRegular);

Exemplo

Vamos obter todas as correspondências e iterar sobre elas com um loop:

javascriptlet str = '12 34 56';
let matches = str.matchAll(/(\d)(\d)/g);

for (let match of matches) {
  console.log(match);
}

Resultado da execução do código:

javascript['12', '1', '2']
['34', '3', '4']
['56', '5', '6'] 

Exemplo

Vamos transformar o objeto iterável em um array comum:

javascriptlet str = '12 34 56';
let matches = str.matchAll(/(\d)(\d)/g);
let res = Array.from(matches);

console.log(res);

Resultado da execução do código:

javascript[
  ['12', '1', '2'],
  ['34', '3', '4'],
  ['56', '5', '6']
]

Veja também

  • método test,
    que verifica uma string
  • método match,
    que busca 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