CKTIS / JavaScript
RegExp lastIndex — posição da correspondência seguinte
lastIndex guarda a posição da pesquisa seguinte para expressões regulares com a flag g ou y. É uma propriedade modificável de cada instância RegExp, não uma propriedade do protótipo.
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.lastIndex
regexp.lastIndex = indexApesar da designação RegExp.prototype.lastIndex, lastIndex é uma propriedade própria de cada instância de RegExp e começa com o valor 0. É modificável, não enumerável e não configurável. As posições são contadas em unidades de código UTF-16, não em caracteres percecionados pelo utilizador.
Nos métodos integrados exec() e test(), lastIndex é o ponto de partida da pesquisa quando está ativa a flag g ou y. Com g sem y, a pesquisa pode encontrar uma correspondência numa posição posterior; com y, não são testadas posições posteriores. Em modo Unicode (u ou v), se lastIndex apontar para o substituto baixo de um par de substitutos UTF-16 válido, uma correspondência com y pode começar no substituto alto que o antecede. Em caso de sucesso, o índice passa para imediatamente depois da correspondência; em caso de insucesso, é reposto a zero, mesmo que ultrapasse o comprimento da cadeia. Mesmo sem nenhuma das duas flags, o algoritmo de pesquisa integrado lê lastIndex e aplica ToLength ao seu valor. Se a conversão for bem-sucedida, o algoritmo começa a pesquisa em 0 e não atualiza a propriedade. Se o valor for um Symbol, a conversão lança uma exceção TypeError e a pesquisa não chega a começar.
Podes atribuir regexp.lastIndex = index; quando é utilizado, o valor é convertido através de ToLength. O estado pertence à expressão, não à cadeia: define lastIndex = 0 ou cria outra instância antes de uma pesquisa independente. Chamadas repetidas a test() com g ou y também alteram o estado.
Uma correspondência vazia em exec() não avança automaticamente o índice, pelo que um ciclo ingénuo pode nunca terminar. O exemplo usa correspondências não vazias e mostra o avanço, a reposição após um insucesso e a retoma manual.
Exemplos
const re = /a/g;
const text = "a_a";
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
re.lastIndex = 2;
console.log(re.exec(text).index, re.lastIndex);Resultado
true 1 true 3 false 0 2 3
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.