O métodoexec() executa a busca por um padrão em uma determinada string. Retorna um array, ounull.

Se você está precisa somente de um retorno verdadeiro/falso, use o métodoRegExp.prototype.test() ouString.prototype.search().

Sintaxe

regexObj.exec(string)

Parâmetros

string

A string para comparar com a expressão regular

Valor retornado

Se a combinação acontecer, o métodoexec() o método retorna um array e atualiza as propriedades do objeto da expressão regular. Esse array retornado possui o texto combinado como primeiro item e depois um item para cada captura contendo o respectivo texto.

Se falhar, o retorno do métodoexec() seránull.

Descrição

Considere o exemplo abaixo:

// Encontra combinações "quick brown" seguido de "jumps", ignorando caracteres entre eles// Relembra "brown" e "jumps"// Ignora caixa (maiúsculo e minúsculo)var re = /quick\s(brown).+?(jumps)/gi;var result = re.exec("The Quick Brown Fox Jumps Over The Lazy Dog");

A tabela a seguir provê os resultados do script:

Exemplos

Procurando combinações sucessivas

If your regular expression uses the "g" flag, you can use theexec() method multiple times to find successive matches in the same string. When you do so, the search starts at the substring ofstr specified by the regular expression'slastIndex property (test() will also advance thelastIndex property). For example, assume you have this script:

var myRe = /ab*/g;var str = "abbcdefabh";var myArray;while ((myArray = myRe.exec(str)) !== null) {  var msg = "Found " + myArray[0] + ". ";  msg += "Next match starts at " + myRe.lastIndex;  console.log(msg);}

This script displays the following text:

Found abb. Next match starts at 3Found ab. Next match starts at 9

Nota: Do not place the regular expression literal (orRegExp constructor) within thewhile condition or it will create an infinite loop if there is a match due to thelastIndex property being reset upon each iteration. Also be sure that the global flag is set or a loop will occur here also.

Usandoexec() comRegExp literais

You can also useexec() without creating aRegExp object:

var matches = /(hello \S+)/.exec("This is a hello world!");console.log(matches[1]);

This will log a message containing 'hello world!'.

Especificações

Compatibilidade com navegadores

Veja também

• O capítulo deExpressões Regulares noGuia de Javascript.
• RegExp