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 représentant des expressions rationnelles gardent un état en mémoire lorsqu'ils utilisent les marqueurs global ou sticky et ils gardent notamment en mémoire lastIndex à partir de la correspondance précédemment trouvée. Ainsi, exec() peut être utilisée afin de parcourir plusieurs correspondances dans un texte (avec des groupes capturants) (contrairement à String.prototype.match()).

Syntaxe

regexObj.exec(chaîne);

Paramètres

chaîne

La chaîne de caractères dans laquelle on recherche la correspondance décrite par l'expression rationnelle.

Valeur de retour

S'il y a une correspondance, la méthode exec() renvoie un tableau (contenant des éléments et deux propriétés index et values, cf. ci-après) et met à jour les propriétés de l'objet représentant l'expression rationnelle (notamment lastIndex). Le tableau renvoyé contient le texte qui correspond dans le premier élément puis un élément pour chaque groupe capturé dans les parenthèses capturantes.

S'il n'y a aucune correspondance, la méthode exec() renvoie null et la propriété lastIndex reçoit 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 caractères entre
// On garde en mémoire "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 résultant suite à ce script :

Exemples

Trouver des correspondances successives

Si on utilise le drapeau "g" dans l'expression rationnelle, on peut utiliser la méthode exec() plusieurs fois afin de trouver les correspondances successives dans la chaîne. Lorsqu'on procède ainsi, la recherche reprend à la position indiquée par la propriété lastIndex (test() fera également progresser la propriété lastIndex).

On notera que la propriété lastIndex ne sera pas réinitialisée lors de la recherche sur une autre chaîne de caractères, c'est la valeur existante de lastIndex qui sera utilisée.

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 littéraux

Il est aussi possible d'utiliser exec() sans créer d'objet RegExp explicite :

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

Cela affichera 'coucou monde !'.

Spécifications

Compatibilité des navigateurs

Voir aussi

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