regExp.lastIndex
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
La propriété lastIndex
est un entier en lecture/écriture qui permet de définir l'indice (position) à partir duquel chercher la prochaine correspondance pour une instance d'expression rationnelle donnée.
Exemple interactif
Attributs de regExp.lastIndex | |
---|---|
Écrivable | Oui |
Énumérable | Non |
Configurable | Non |
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
etregexp.exec
échoueront etlastIndex
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 delastIndex
. - 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 etlastIndex
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
Specification |
---|
ECMAScript Language Specification # sec-properties-of-regexp-instances |
Compatibilité des navigateurs
BCD tables only load in the browser