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.

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 drapeau (flag) "g" pour effectuer une recherche globale. 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

Utiliser lastIndex

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 2017 Draft (ECMA-262)
La définition de 'RegExp.lastIndex' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple (Oui) (Oui) (Oui) (Oui) (Oui)
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple (Oui) (Oui) (Oui) (Oui) (Oui) (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,