regExp.lastIndex
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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
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
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Définition initiale. JavaScript 1.5 : lastIndex est une propriété d'une instance de RegExp et n'est pas une propriété directe de RegExp . |
ECMAScript 5.1 (ECMA-262) La définition de 'RegExp.lastIndex' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'RegExp.lastIndex' dans cette spécification. |
Standard | |
ECMAScript (ECMA-262) La définition de 'RegExp.lastIndex' dans cette spécification. |
Standard évolutif |
Compatibilité des navigateurs
BCD tables only load in the browser