Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

RegExp.prototype.exec — correspondências e grupos de captura

RegExp.prototype.exec procura uma correspondência e devolve um array com o texto correspondente e as capturas, ou null. As flags g e y fazem com que chamadas sucessivas utilizem lastIndex e atualizem o seu valor.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

regexp.exec(string)

regexp.exec(string) realiza uma correspondência com uma expressão regular. O argumento é convertido numa cadeia de caracteres; o método integrado exige uma instância real de RegExp como this. O resultado é um array ou null, não um valor booleano. Verifique o resultado antes de ler as respetivas propriedades.

match[0] contém a correspondência completa, e match[1] e os elementos seguintes contêm os grupos de captura. Um grupo que não tenha participado na correspondência produz undefined. match.index é a posição inicial em unidades de código UTF-16, e match.input é a cadeia pesquisada. match.groups contém os grupos com nome, ou undefined se o padrão não tiver nenhum. A flag d também disponibiliza match.indices com pares de início/fim; o fim é exclusivo.

Sem g nem y, a pesquisa começa na posição 0 e não altera lastIndex. Se pelo menos uma destas flags estiver ativa, a pesquisa usa como ponto de partida o resultado da aplicação de ToLength a lastIndex (por exemplo, 1.9 passa a 1). Com g mas sem y, a pesquisa pode tentar posições posteriores após uma tentativa falhada; com y, não o faz. Em modo Unicode (u ou v), se o valor convertido de lastIndex apontar para a segunda unidade de um par de substitutos UTF-16, a correspondência pode começar na primeira unidade desse par. Assim, mesmo com y, o valor devolvido em match.index pode diferir do valor convertido de lastIndex. Em caso de sucesso, lastIndex é definido como o fim da correspondência; em caso de falha, é reposto a zero. Antes de reutilizar esse objeto numa pesquisa independente, defina lastIndex = 0.

Mantenha o mesmo objeto RegExp dentro de um ciclo. Atenção: uma correspondência vazia não avança automaticamente lastIndex; sem avanço explícito ou interrupção, o ciclo poderá nunca terminar. O exemplo utiliza um padrão que corresponde sempre a pelo menos um caráter e demonstra a reposição após a falha final.

Exemplos

const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
  console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);

Resultado

["x=12","x","12",0,4]
["y=7","y","7",5,8]
0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes