Skip to main content
adicionou 315 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170

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:

Uma diferença é que match retorna um array e matchAll retorna um iterador, mas tem vários outros detalhes a se atentar.

Quando a regex não tem a flag g, 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('---match---');
// 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('---matchAll---');
// 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]}`);

Antes de matchAll, a única forma de obter as informações adicionais para todas as ocorrências era usando exec:

Repare que agora cada chamada de exec retorna um array contendo o match e as informações adicionais.

Mas com matchAll fica um pouco mais simples fazer a mesma coisa:

E como 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 matchAll, a regex deve obrigatoriamente ter a flag g, caso contrário dará erro (e uma curiosidade é que se você usar 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: exec atualiza o lastIndex da regex, então cada chamada passa a procurar a partir desta posição. Mas matchAll não mexe no lastIndex:

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('---sem 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('---com 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:

adicionou 704 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170

Por fim, outra diferença entre eles é o suporte dos browsers: String.prototype.match e RegExp.prototype.exec são compatíveis com versões mais antigas (inclusive o IE 4!), enquanto String.prototype.matchAll só foi introduzido em versões mais novas (e não funciona no IE). Consulte as tabelas de compatibilidade aqui, aqui e aqui.


Por fim, outra diferença entre eles é o suporte dos browsers: String.prototype.match e RegExp.prototype.exec são compatíveis com versões mais antigas (inclusive o IE 4!), enquanto String.prototype.matchAll só foi introduzido em versões mais novas (e não funciona no IE). Consulte as tabelas de compatibilidade aqui, aqui e aqui.

removeu 27 caracteres do conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
let s = 'a1 b2 c3 d4';
let r = /[a-z](\d)/g;
for (const match of s.matchAll(/[a-z](\d)/g)) {
    console.log('----');
    for (let i in match) console.log(`${i}=${match[i]}`);
}
let s = 'a1 b2 c3 d4';
let r = /[a-z](\d)/g;
for (const match of s.matchAll(/[a-z](\d)/g)) {
    console.log('----');
    for (let i in match) console.log(`${i}=${match[i]}`);
}
let s = 'a1 b2 c3 d4';
for (const match of s.matchAll(/[a-z](\d)/g)) {
    console.log('----');
    for (let i in match) console.log(`${i}=${match[i]}`);
}
adicionou 1 caractere ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando
adicionou 192 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando
adicionou 89 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando
adicionou 685 caracteres ao conteúdo
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando
Fonte Link
hkotsubo
  • 66,9mil
  • 25
  • 87
  • 170
Carregando