RegExp.leftContext ($`)
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.leftContext retourne la sous-chaîne de caractères précédant la correspondance la plus récente. RegExp["$`"] est un alias pour cette propriété.
Description
Comme leftContext est une propriété statique de RegExp, vous l'utilisez toujours comme RegExp.leftContext ou RegExp["$`"], plutôt que comme une propriété d'un objet RegExp que vous avez créé.
La valeur de leftContext est mise à jour chaque fois qu'une instance de RegExp (mais pas une sous-classe de RegExp) réussit une correspondance. Si aucune correspondance n'a été effectuée, leftContext est une chaîne de caractères vide. L'accesseur en écriture de leftContext est undefined, donc vous ne pouvez pas modifier cette propriété directement.
Vous ne pouvez pas utiliser l'alias raccourci avec l'accesseur de propriété par point (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é pour remplacer une chaîne de caractères de String.prototype.replace(), mais cela n'a aucun rapport avec la propriété héritée RegExp["$`"].
Exemples
Utiliser leftContext et `$``
const re = /monde/g;
re.test("coucou monde !");
RegExp.leftContext; // "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.lastMatch($&) - La propriété statique
RegExp.lastParen($+) - La propriété statique
RegExp.rightContext($') - La propriété statique
RegExp.$1, …,RegExp.$9