Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

RegExp lastIndex — position du prochain résultat

lastIndex mémorise la prochaine position de recherche pour les expressions régulières avec le drapeau g ou y. C’est une propriété modifiable de chaque instance RegExp, et non une propriété du prototype.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

regexp.lastIndex
regexp.lastIndex = index

Malgré l’appellation RegExp.prototype.lastIndex, lastIndex est une propriété propre à chaque instance de RegExp, initialisée à 0. Elle est modifiable, non énumérable et non configurable. Les positions sont comptées en unités de code UTF-16, et non en caractères perçus par l’utilisateur.

Avec les méthodes intégrées exec() et test(), lastIndex sert de point de départ à la recherche lorsque le drapeau g ou y est activé. Avec g sans y, une correspondance peut commencer à une position ultérieure ; avec y, les positions ultérieures ne sont pas essayées. En mode Unicode (u ou v), si lastIndex pointe sur le demi-codet bas d’une paire de substitution UTF-16 valide, une correspondance avec y peut commencer au demi-codet haut qui le précède. En cas de réussite, l’index est placé juste après le résultat ; en cas d’échec, il est remis à zéro, même s’il dépasse la longueur de la chaîne. Même si aucun des deux drapeaux n’est activé, l’algorithme de recherche intégré lit lastIndex et applique ToLength à sa valeur. Si la conversion réussit, l’algorithme lance la recherche à partir de 0 sans mettre à jour la propriété. Si la valeur est un Symbol, la conversion lève une exception TypeError et la recherche ne démarre pas.

Tu peux affecter une valeur avec regexp.lastIndex = index ; lorsqu’elle est utilisée, elle subit la conversion ToLength. L’état appartient à l’expression, pas à la chaîne : définis lastIndex = 0 ou crée une autre instance avant une recherche indépendante. Des appels répétés à test() avec g ou y modifient également l’état.

Un résultat vide dans exec() ne fait pas avancer automatiquement l’index ; une boucle naïve peut donc ne jamais se terminer. L’exemple utilise des résultats non vides et montre la progression, la remise à zéro après un échec et la reprise manuelle.

Exemples

const re = /a/g;
const text = "a_a";
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
console.log(re.test(text), re.lastIndex);
re.lastIndex = 2;
console.log(re.exec(text).index, re.lastIndex);

Résultat

true 1
true 3
false 0
2 3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources