CKTIS / JavaScript
Groupes de capture nommés de RegExp et substitutions de remplacement
Récupérez le texte capturé par son nom, puis réutilisez-le dans une chaîne ou une fonction de remplacement, même si un groupe est facultatif.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
/(?<name>pattern)/
/(?<name>pattern)\k<name>/
regexp.exec(text)?.groups?.name
text.replace(regexp, "$<name>")
text.replace(regexp, replacer)
text.replaceAll(globalRegexp, replacement)
Replacement string tokens: $$, $&, $`, $', $1 … $99, $<name>(?<name>...) capture le texte reconnu par un sous-motif. Les groupes nommés et anonymes sont numérotés ensemble à partir de 1, dans l’ordre des parenthèses ouvrantes ; (?:...) ne capture rien. Après un exec() réussi, la valeur se lit avec result.groups.name ; un groupe qui n’a pas participé à la correspondance vaut undefined. Dans le motif, \k<name> est une référence arrière qui sert à reconnaître le texte capturé, et non à l’insérer dans le résultat du remplacement.
Dans une chaîne de remplacement, $<name> insère une capture nommée, $1 la première capture, $& la correspondance entière et $$ un signe dollar. $` et $' insèrent le texte d’origine avant et après la correspondance, respectivement. Si le motif contient des groupes nommés, un nom inconnu ou un groupe qui n’a pas participé donne une chaîne vide. Sans groupe nommé, $<name> reste littéral. Un groupe numéroté existant qui n’a pas participé donne aussi une chaîne vide ; si le groupe 12 n’existe pas, $12 peut désigner $1 suivi du caractère 2, à condition que le groupe 1 existe.
La fonction de remplacement reçoit la correspondance entière, les valeurs des captures dans l’ordre, la position en unités de code UTF-16, la chaîne d’entrée et enfin un objet groups uniquement si le motif contient des groupes nommés. Les captures qui n’ont pas participé valent undefined. La valeur renvoyée n’est pas interprétée comme un modèle de remplacement : utilisez () => text pour insérer littéralement du texte contenant $.
Avec une RegExp standard, replace() ne remplace que la première correspondance en l’absence de g et de y, et remplace toutes les correspondances avec g sans y. Avec y sans g, la méthode remplace au plus une correspondance, qui doit commencer à la position indiquée par la valeur actuelle de lastIndex. Avec gy, elle commence à la position 0 et s’arrête dès qu’il n’y a pas de correspondance à la position courante, sans chercher plus loin. replaceAll() lève une TypeError si l’expression régulière n’a pas le drapeau g. Les deux méthodes renvoient une chaîne résultat sans modifier l’entrée.
Les noms de groupes suivent la syntaxe des identifiants. Un nom invalide déclenche une SyntaxError, tout comme un nom répété en ECMAScript 2024. ECMAScript 2025 autorise un même nom dans des branches distinctes d’une même disjonction |. Vérifiez la prise en charge dans l’environnement cible ; pour rester compatible avec ECMAScript 2024, utilisez des noms uniques.
Exemples
const text = "AB-12 CD";
const token = /(?<code>[A-Z]{2})(?:-(?<number>\d+))?/g;
console.log(text.replace(token, "[$<code>:$<number>]"));
console.log(text.replace(token, (match, code, number, offset, input, groups) =>
`[${groups.code}:${groups.number ?? "none"}]`
));Résultat
[AB:12] [CD:] [AB:12] [CD:none]
Pour `CD`, le groupe `number` ne participe pas. La chaîne de remplacement laisse le champ vide, tandis que la fonction insère `none`.
Leçons associées
- JavaScript · Leçon 25 · Intermédiaire · Version : 3
Sources
- ECMAScript 2024 — GetSubstitution
- ECMAScript 2024 — RegExp.prototype [ %Symbol.replace% ]
- ECMAScript 2024 — RegExp Pattern Early Errors
- ECMAScript 2025 — MightBothParticipate
- Named capturing group: (?<name>...) - JavaScript | MDN
- Named backreference: \k<name> - JavaScript | MDN
- String.prototype.replace() - JavaScript | MDN
- String.prototype.replaceAll() - JavaScript | MDN