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

js
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

js
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

BCD tables only load in the browser

Voir aussi