Uma diferença é que String.prototype.match
retorna um array e String.prototype.matchAll
retorna um iterador, mas tem vários outros detalhes a se atentar.
String.prototype.match
Quando a regex não tem a flag g
, o método String.prototype.match
retorna um array contendo somente a primeira ocorrência, e mais algumas informações relacionadas (como por exemplo os grupos de captura). Mas quando tem a flag g
, o resultado contém somente os matches, sem informações adicionais:
let s = 'a1 b2 c3 d4';
console.log('---matchsem flag "g"---');
// sem flag g, pega somente a primeira ocorrência, com informações adicionais
let result = s.match(/[a-z](\d)/);
for (let i in result) console.log(`${i}=${result[i]}`);
console.log('---matchAllcom flag "g"---');
// com flag g, pega todas as ocorrências, sem informações adicionais
result = s.match(/[a-z](\d)/g);
for (let i in result) console.log(`${i}=${result[i]}`);
String.prototype.matchAll
Antes de existir o método String.prototype.matchAll
, a única forma de obter as informações adicionais para todas as ocorrências era usando o método RegExp.prototype.exec
:
Repare que agora cada chamada de RegExp.prototype.exec
retorna um array contendo o match e as informações adicionais.
Mas com String.prototype.matchAll
fica um pouco mais simples fazer a mesma coisa:
E como String.prototype.matchAll
retorna um iterador, dá para usá-lo com for..of
(como no exemplo acima), com spread para criar um array com os resultados ([...s.matchAll(/[a-z](\d)/g)]
), etc.
Um detalhe é que com String.prototype.matchAll
, a regex deve obrigatoriamente ter a flag g
, caso contrário dará erro (e uma curiosidade é que se você usar RegExp.prototype.exec
sem a flag g
, ele entra em loop infinito, já que exec
faz a busca a partir do lastIndex
, mas sem a flag g
este valor sempre é zero, então neste caso ela sempre vai encontrar um match).
Aliás, este é outro detalhe: RegExp.prototype.exec
atualiza o lastIndex
da regex, então cada chamada passa a procurar a partir desta posição. Mas String.prototype.matchAll
não mexe no lastIndex
: