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

CKTIS / JavaScript

RegExp.prototype.exec — coincidencias y grupos de captura

RegExp.prototype.exec busca una coincidencia y devuelve un array con el texto coincidente y las capturas, o null. Las marcas g e y hacen que las llamadas sucesivas usen lastIndex y actualicen su valor.

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.exec(string)

regexp.exec(string) realiza una búsqueda con una expresión regular. El argumento se convierte en una cadena; el método integrado requiere una instancia real de RegExp como this. El resultado es un array o null, no un valor booleano. Comprueba el resultado antes de leer sus propiedades.

match[0] contiene la coincidencia completa, y match[1] y los elementos siguientes contienen los grupos de captura. Un grupo que no haya participado produce undefined. match.index es la posición inicial en unidades de código UTF-16, y match.input es la cadena en la que se realiza la búsqueda. match.groups contiene los grupos con nombre o undefined si el patrón no tiene ninguno. La marca d también proporciona match.indices con pares de inicio y fin; el extremo final es exclusivo.

Sin g ni y, la búsqueda comienza en la posición 0 y deja lastIndex sin cambios. Si alguna de estas marcas está activa, la búsqueda toma como punto de partida el resultado de aplicar ToLength a lastIndex (por ejemplo, 1.9 se convierte en 1). Con g pero sin y, la búsqueda puede probar posiciones posteriores tras un intento fallido; con y, no lo hace. En modo Unicode (u o v), si el valor convertido de lastIndex apunta a la segunda unidad de un par sustituto UTF-16, una coincidencia puede empezar en la primera unidad de ese par. Por tanto, incluso con y, el valor devuelto en match.index no tiene por qué ser igual al valor convertido de lastIndex. Si hay éxito, lastIndex pasa al final de la coincidencia; si falla, se restablece a cero. Antes de reutilizar ese objeto para una búsqueda independiente, asigna lastIndex = 0.

Usa el mismo objeto RegExp dentro de un bucle. Atención: una coincidencia vacía no hace avanzar lastIndex automáticamente; sin un avance explícito o una interrupción, el bucle podría no terminar nunca. El ejemplo usa un patrón que siempre coincide con al menos un carácter y muestra el reinicio tras el fallo final.

Ejemplos

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

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