RegExp.prototype.sticky

La propriété sticky (adhérante) permet de déterminer si la recherche s'effectue uniquement à partir de l'indice lastIndex lié à l'expression rationnelle ou non). sticky est une propriété accessible en lecture seule, rattachée à l'instance.

Description

La propriété sticky est un booléen qui vaut true si le marqueur (flag) "y" a été utilisé, false sinon. Ce marqueur indique que les correspondances ne sont recherchées qu'à partir de l'indice lastIndex au niveau de la chaîne de caractères (les correspondances à partir des autres positions ne seront pas trouvées).

La propriété sticky ne peut pas être modifiée directement. Elle est uniquement en lecture seule.

Exemples

Utiliser une expression rationnelle avec le flag sticky

var str = '#toto#';
var regex = /toto/y;

regex.lastIndex = 1;
regex.test(str); // true
regex.lastIndex = 5;
regex.test(str); // false (lastIndex est pris en compte avec sticky)
regex.lastIndex; // 0 (on rénitialise après un échec)

Marqueur d'adhérence « ancré »

Ce comportement a été spécifié avec ES2015 et diffère des implémentations précédentes, présentes pour Firefox. Lorsque le marqueur y est utilisé avec un motif, ^ correspond toujours au début de la saisie ou, si multiline vaut true, au début d'une ligne.

var regex = /^foo/y;
regex.lastIndex = 2; // désactive la correspondance au début
regex.test("..foo"); // false

var regex2 = /^foo/my;
regex2.lastIndex = 2;
regex2.test("..foo"); // false
regex2.lastIndex = 2;
regex2.test(".\nfoo"); // true

Spécifications

Compatibilité des navigateurs

• RegExp.prototype.global
• RegExp.prototype.ignoreCase
• RegExp.prototype.lastIndex
• RegExp.prototype.multiline
• RegExp.prototype.source