Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

RegExp lastIndex — posición de la siguiente coincidencia

lastIndex almacena la siguiente posición de búsqueda para expresiones regulares con la bandera g o y. Es una propiedad modificable de cada instancia de RegExp, no una propiedad del prototipo.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

regexp.lastIndex
regexp.lastIndex = index

Aunque se denomine RegExp.prototype.lastIndex, lastIndex es una propiedad propia de cada instancia de RegExp y su valor inicial es 0. Es modificable, no enumerable y no configurable. Las posiciones se cuentan en unidades de código UTF-16, no en caracteres percibidos por las personas.

En los métodos integrados exec() y test(), lastIndex es el punto de partida de la búsqueda con g o y. Con g sin y, la búsqueda puede encontrar una coincidencia en una posición posterior; con y, no se prueban posiciones posteriores. En modo Unicode (u o v), si lastIndex apunta al sustituto bajo de un par sustituto UTF-16 válido, una coincidencia con y puede empezar en el sustituto alto que lo precede. Si hay éxito, el índice se establece justo después de la coincidencia; si falla, se restablece a cero, incluso si supera la longitud de la cadena. Incluso sin ninguna de las dos banderas, el algoritmo de búsqueda integrado lee lastIndex y aplica ToLength a su valor. Si la conversión se completa correctamente, el algoritmo empieza la búsqueda en 0 y no actualiza la propiedad. Si el valor es un Symbol, la conversión lanza un TypeError y la búsqueda no empieza.

Puedes asignar regexp.lastIndex = index; cuando se usa, el valor se convierte mediante ToLength. El estado pertenece a la expresión, no a la cadena: establece lastIndex = 0 o crea otra instancia antes de una búsqueda independiente. Las llamadas repetidas a test() con g o y también cambian el estado.

Una coincidencia vacía en exec() no avanza el índice automáticamente, por lo que un bucle ingenuo puede no terminar nunca. El ejemplo usa coincidencias no vacías y muestra el avance, el restablecimiento tras un fallo y la reanudación manual.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes