RegExp.prototype.exec()

Exemple interactif

const regex1 = RegExp("foo*", "g");
const str1 = "table football, foosball";
let array1;

while ((array1 = regex1.exec(str1)) !== null) {
  console.log(`Found ${array1[0]}. Next starts at ${regex1.lastIndex}.`);
  // Expected output: "Found foo. Next starts at 9."
  // Expected output: "Found foo. Next starts at 19."
}

Les objets reprsentant des expressions rationnelles gardent un tat en mmoire lorsqu'ils utilisent les marqueurs global ou sticky et ils gardent notamment en mmoire lastIndex partir de la correspondance prcdemment trouve. Ainsi, exec() peut tre utilise afin de parcourir plusieurs correspondances dans un texte (avec des groupes capturants) (contrairement String.prototype.match()).

Syntaxe

regexObj.exec(chane);

Paramtres

chane

La chane de caractres dans laquelle on recherche la correspondance dcrite par l'expression rationnelle.

Valeur de retour

S'il y a une correspondance, la mthode exec() renvoie un tableau (contenant des lments et deux proprits index et values, cf. ci-aprs) et met jour les proprits de l'objet reprsentant l'expression rationnelle (notamment lastIndex). Le tableau renvoy contient le texte qui correspond dans le premier lment puis un lment pour chaque groupe captur dans les parenthses capturantes.

S'il n'y a aucune correspondance, la mthode exec() renvoie null et la proprit lastIndex reoit la valeur 0.

Description

Si on a l'exemple suivant :

// On a une correspondance si on a "quick brown" suivi par "jumps", on ignore les caractres entre
// On garde en mmoire "brown" et "jumps"
// On ignore la casse
var re = /quick\s(brown).+?(jumps)/gi;
var result = re.exec("The Quick Brown Fox Jumps Over The Lazy Dog");

Le tableau suivant montre l'tat rsultant suite ce script :

Exemples

Trouver des correspondances successives

Si on utilise le drapeau "g" dans l'expression rationnelle, on peut utiliser la mthode exec() plusieurs fois afin de trouver les correspondances successives dans la chane. Lorsqu'on procde ainsi, la recherche reprend la position indique par la proprit lastIndex (test() fera galement progresser la proprit lastIndex).

On notera que la proprit lastIndex ne sera pas rinitialise lors de la recherche sur une autre chane de caractres, c'est la valeur existante de lastIndex qui sera utilise.

Par exemple, si on utilise le fragment de code suivant :

var maRegex = /ab*/g;
var str = "abbcdefabh";
var monTableau;
while ((monTableau = maRegex.exec(str)) !== null) {
  var msg = "Trouv " + monTableau[0] + ". ";
  msg += "Prochaine correspondance  partir de " + maRegex.lastIndex;
  console.log(msg);
}

Le script affichera alors :

Trouv abb. Prochaine correspondance  partir de 3
Trouv ab. Prochaine correspondance  partir de 9

Utiliser exec() avec des littraux

Il est aussi possible d'utiliser exec() sans crer d'objet RegExp explicite :

var matches = /(coucou \S+)/.exec("Ceci est un coucou monde !");
console.log(matches[1]);

Cela affichera 'coucou monde !'.

Spcifications

Compatibilit des navigateurs

Voir aussi

• Le chapitre sur les expressions rationnelles du Guide JavaScript
• RegExp
• String.prototype.match()
• String.prototype.matchAll()