RegExp.leftContext ($`)

Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

La propriété non-standard leftContext est une propriété statique accessible uniquement en lecture. Cette propriété liée aux expressions rationnelles contient la sous-chaîne qui précède la correspondance la plus récente. RegExp.$` est un alias pour cette propriété.

Syntaxe

RegExp.leftContext
RegExp['$`']

Description

La propriété leftContext est une propriété statique, elle n'est donc pas distincte entre les différents objets représentants les expressions rationnelles. Il faut donc toujours utiliser la syntaxe RegExp.leftContext ou RegExp['$`'].

La valeur de la propriété leftContext n'est accessible uniquement qu'en lecture. Elle est modifiée par le moteur à chaque fois qu'une nouvelle correspondance est trouvée.

L'alias ne peut pas être utilisé avec la notation utilisant le point (RegExp.$`). En effet, le parseur attend un gabarit de chaîne à la suite de l'accent grave. Si on utilise le point, on aura donc une exception SyntaxError. Pour cet alias, on utilisera la notation à base de crochets.

Exemples

Utiliser leftContext et $`

var re = /monde/g;
re.test("coucou monde !");
RegExp.leftContext; // "coucou "
RegExp['$`'];       // "coucou "

Spécifications

Cette propriété n'est pas standard et ne fait partie d'aucune spécification.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,