RegExp.prototype.exec()

Sintaxis

regexObj.exec(cadena)

Parametros

cadena

Cadena sobre la cual se quiere aplicar la expresin regular

Valor devuelto

Si se encuentran coincidencial, el mtodo exec() devuelve un array y actualiza las propiedades del objeto de la expresin regular. El array devuelto contiene los elementos encontrados en su primer elemento, y un elemento por cada parte de la expresin regular que se encuentra entre parentesis y se encuentra dentro del texto que fu capturado.

Si la busqueda falla, el mtodo exec() devuelve null.

Descripcin

Considerando el siguiente ejemplo:

// Busca "quick brown" seguido de "jumps", ignorando los caracteres que se
// encuentren entre medias.
// Recuerda "brown" y "jumps"
// Ignora mayusculas y minusculas
var re = /quick\s(brown).+?(jumps)/gi;
var result = re.exec("The Quick Brown Fox Jumps Over The Lazy Dog");

La siguiente tabla muestra el resultado de este script:

Ejemplos

Encontrando coincidencias sucesivas

Si tu expresin regular contiene la bandera "g", puedes usar el mtodo exec() varias veces para encontrar coincidencias sucesivas en la misma cadena. Cuando lo haces, la busqueda empieza en la subcadena str especificada por la propiedad lastIndex de la expresin regular (test() tambin movera hacia adelante el indice de la propiedad lastIndex). Por ejemplo, asumiendo que tienes este script:

var myRe = /ab*/g;
var str = "abbcdefabh";
var myArray;
while ((myArray = myRe.exec(str)) !== null) {
  var msg = "Se ha encontrado " + myArray[0] + ". ";
  msg += "La siguiente coincidencia empieza en el indice " + myRe.lastIndex;
  console.log(msg);
}

Este script muestra el siguiente texto:

Se ha encontrado abb. La siguiente coincidencia empieza en el indice 3
Se ha encontrado ab. La siguiente coincidencia empieza en el indice 9

Nota: No uses la expresin regular literalmente (o el constructor RegExp) dentro de la condicin del bucle while o se crear un bucle infinito si hay una coincidencia, por culpa de que la propiedad lastIndex va a ser reiniciada por cada iteracin del bucle. Adems asegurate de que has usado la bandera de busqueda global "g" o se crear un bucle tambin.

Usando exec() con RegExp literales

Tambin se puede usar exec() sin crear un objeto de RegExp:

var matches = /(hola \S+)/.exec("Esto es un hola mundo!");
console.log(matches[1]);

Esto loguear un mensaje que contiene 'hola mundo!'.

Especificaciones

Compatibilidad con navegadores

Ver tambin

• Captulo de Expresiones Regulares en la Gua de Javascript
• RegExp