RegExp.lastMatch ($&)
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets.
The RegExp static properties may have unintended side effects.
Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
Note :
Toutes les propriétés statiques de RegExp qui exposent l'état de la dernière correspondance globalement sont obsolètes. Voir Fonctionnalités RegExp obsolètes pour plus d'informations.
La propriété d'accesseur statique RegExp.lastMatch retourne la dernière sous-chaîne de caractères correspondante. RegExp["$&"] est un alias pour cette propriété.
Description
Comme lastMatch est une propriété statique de RegExp, vous l'utilisez toujours comme RegExp.lastMatch ou RegExp["$&"], plutôt que comme une propriété d'un objet RegExp que vous avez créé.
La valeur de lastMatch est mise à jour chaque fois qu'une instance de RegExp (mais pas une sous-classe de RegExp) trouve une correspondance avec succès. Si aucune correspondance n'a été trouvée, lastMatch est une chaîne de caractères vide. L'accesseur en écriture de lastMatch est undefined, vous ne pouvez donc pas modifier cette propriété directement.
Vous ne pouvez pas utiliser l'alias avec la notation utilisant le point pour accéder à la propriété (RegExp.$&), car & n'est pas une partie valide d'un identifiant, ce qui provoque une SyntaxError. Utilisez plutôt la notation avec les crochets.
$& peut également être utilisé dans la chaîne de caractères de remplacement de String.prototype.replace(), mais cela n'a aucun rapport avec la propriété héritée RegExp["$&"].
Exemples
Utiliser lastMatch et $&
const re = /coucou/g;
re.test("coucou toi!");
RegExp.lastMatch; // "coucou"
RegExp["$&"]; // "coucou"
Spécifications
| Spécification |
|---|
| Legacy RegExp features # additional-properties-of-the-regexp-constructor |
Compatibilité des navigateurs
Voir aussi
- La propriété statique
RegExp.input($_) - La propriété statique
RegExp.lastParen($+) - La propriété statique
RegExp.leftContext($`) - La propriété statique
RegExp.rightContext($') - La propriété statique
RegExp.$1, …,RegExp.$9