CKTIS / JavaScript
String.prototype.matchAll — un itérateur de correspondances avec groupes capturants
String.prototype.matchAll renvoie un itérateur sur les correspondances d’une expression régulière, avec les groupes capturants et leurs positions. Avec un RegExp ordinaire, le drapeau g est requis et le lastIndex du motif d’origine reste inchangé.
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
string.matchAll(regexp)String.prototype.matchAll permet de parcourir les correspondances d’un motif dans un texte. Avec le comportement standard de RegExp, la méthode renvoie un itérateur paresseux : chaque étape fournit un tableau dont [0] contient la correspondance complète et dont [1], [2], etc. contiennent les groupes capturants. Un groupe facultatif sans correspondance vaut undefined. La propriété index indique la position en unités de code UTF-16, input contient le texte d’entrée et groups expose les groupes nommés, s’il y en a.
Si l’argument est reconnu comme une expression régulière, matchAll vérifie la présence du drapeau g avant de rechercher Symbol.matchAll. En l’absence de ce drapeau, l’appel déclenche une TypeError. La recherche prend aussi en compte les propriétés héritées : si la valeur trouvée est appelable, matchAll l’appelle et renvoie son résultat. Si la propriété est absente ou vaut undefined ou null, matchAll crée un RegExp à partir de l’argument avec le drapeau g. Dans ce cas, une chaîne est interprétée comme un motif d’expression régulière et non comme du texte littéral. Toute autre valeur non appelable de Symbol.matchAll déclenche une TypeError.
L’implémentation standard de RegExp crée une copie du motif et initialise son lastIndex avec le résultat de l’opération ToLength appliquée au lastIndex de l’original. Par exemple, -1 devient 0 et 2.9 devient 2. Le lastIndex de l’original reste inchangé. Ne suppose donc pas que la recherche commence toujours à zéro. L’itérateur ne s’utilise qu’une fois : une fois épuisé, il ne recommence pas. Aucune correspondance signifie une itération vide, et non null ; utilise for...of pour traiter les résultats ou [...iterator] pour les stocker dans un tableau.
Contrairement à match avec le drapeau g, matchAll conserve les groupes capturants pour chaque correspondance. La méthode fait partie d’ECMAScript 2020, et non des Web APIs. La spécification seule ne permet pas d’établir la prise en charge dans un navigateur particulier ; la présence de Node 24 dans un dépôt ne le prouve pas non plus. Dans l’environnement cible, la disponibilité peut être vérifiée avec typeof String.prototype.matchAll === "function".
Exemples
const text = "x=12 y=7";
const pattern = /([a-z])=(\d+)/g;
const matches = text.matchAll(pattern);
for (const match of matches) {
console.log(`${match[0]} | ${match[1]} | ${match[2]} | ${match.index}`);
}
console.log(`lastIndex=${pattern.lastIndex}`);
console.log(`remaining=${[...matches].length}`);Résultat
x=12 | x | 12 | 0 y=7 | y | 7 | 5 lastIndex=0 remaining=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.