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

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 = index

Apesar 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.

Fontes