regExp.lastIndex

Exemple interactif

const regex1 = new RegExp("foo", "g");
const str1 = "table football, foosball";

regex1.test(str1);

console.log(regex1.lastIndex);
// Expected output: 9

regex1.test(str1);

console.log(regex1.lastIndex);
// Expected output: 19

Syntaxe

regExpObj.lastIndex;

Description

Cette propriété n'est définie que si l'instance d'expression rationnelle utilise le marqueur (flag) "g" pour effectuer une recherche globale ou le marqueur "y" afin d'effectuer une recherche adhérente. Les règles suivantes s'appliquent :

• Si lastIndex est supérieur à la longueur de la chaîne de caractères, regexp.test et regexp.exec échoueront et lastIndex sera redéfini à 0.
• Si lastIndex est égal à la longueur de la chaîne de caractères et si l'expression rationnelle correspond avec la chaîne vide, il y aura une correspondance à partir de lastIndex.
• Si lastIndex est égal à la longueur de la chaîne de caractères et que l'expression rationnelle ne peut correspondre à la chaîne vide, on n'aura pas de correspondance et lastIndex sera réinitialisé à 0.
• Sinon, lastIndex sera défini à la position suivant la correspondance la plus récente.

Exemples

Si on a la séquence d'instructions suivante :

var re = /(hi)?/g;

Correspond à la chaîne vide.

console.log(re.exec("hi"));
console.log(re.lastIndex);

Renvoie ["hi", "hi"] avec lastIndex égal à 2.

console.log(re.exec("hi"));
console.log(re.lastIndex);

Renvoie ["", undefined], un tableau dont le premier élément est la chaîne vide car lastIndex valait 2 (et vaut toujours 2) et "hi" était de longueur 2.

Spécifications

Compatibilité des navigateurs

Voir aussi

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