Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp.prototype.exec — correspondance et groupes de capture

RegExp.prototype.exec recherche une correspondance et renvoie un tableau contenant le texte correspondant et les captures, ou null. Les indicateurs g et y font que les appels successifs utilisent lastIndex et mettent sa valeur à jour.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.exec(string)

regexp.exec(string) effectue une correspondance avec une expression régulière. L’argument est converti en chaîne ; la méthode intégrée exige une véritable instance de RegExp comme this. Le résultat est un tableau ou null, et non une valeur booléenne. Vérifiez le résultat avant de lire ses propriétés.

match[0] contient la correspondance complète, et match[1] ainsi que les éléments suivants contiennent les groupes de capture. Un groupe qui n’a pas participé à la correspondance produit undefined. match.index est la position de départ en unités de code UTF-16, et match.input est la chaîne dans laquelle la recherche est effectuée. match.groups contient les groupes nommés, ou undefined si le motif n’en comporte aucun. L’indicateur d expose également match.indices, avec des paires début/fin ; la fin est exclusive.

Sans g ni y, la recherche commence à la position 0 et ne modifie pas lastIndex. Si l’un de ces indicateurs est activé, la recherche prend pour point de départ le résultat de l’application de ToLength à lastIndex (par exemple, 1.9 devient 1). Avec g mais sans y, la recherche peut essayer des positions ultérieures après un échec ; avec y, elle ne le fait pas. En mode Unicode (u ou v), si la valeur convertie de lastIndex pointe vers le second codet d’une paire de substituts UTF-16, une correspondance peut commencer au premier codet de cette paire. Ainsi, même avec y, la valeur renvoyée dans match.index peut différer de la valeur convertie de lastIndex. En cas de réussite, lastIndex est défini sur la fin de la correspondance ; en cas d’échec, il est remis à zéro. Avant de réutiliser cet objet pour une recherche indépendante, définissez lastIndex = 0.

Conservez le même objet RegExp dans une boucle. Attention : une correspondance vide ne fait pas avancer automatiquement lastIndex ; sans avancement explicite ni interruption, la boucle peut ne jamais se terminer. L’exemple utilise un motif qui correspond toujours à au moins un caractère et montre la remise à zéro après l’échec final.

Exemples

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);

Résultat

["x=12","x","12",0,4]
["y=7","y","7",5,8]
0

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources