CKTIS / JavaScript
RegExp lastIndex — Position des nächsten Treffers
lastIndex speichert die nächste Suchposition für reguläre Ausdrücke mit dem Flag g oder y. Es ist eine beschreibbare Eigenschaft jeder RegExp-Instanz, keine Eigenschaft des Prototyps.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
regexp.lastIndex
regexp.lastIndex = indexTrotz der Bezeichnung RegExp.prototype.lastIndex ist lastIndex eine eigene Eigenschaft jeder RegExp-Instanz und hat anfangs den Wert 0. Sie ist beschreibbar, nicht aufzählbar und nicht konfigurierbar. Positionen werden in UTF-16-Codeeinheiten gezählt, nicht in für Menschen wahrnehmbaren Zeichen.
Bei den eingebauten Methoden exec() und test() dient lastIndex mit g oder y als Ausgangsposition für die Suche. Mit g ohne y ist ein Treffer an einer späteren Position möglich; mit y werden keine späteren Positionen geprüft. Zeigt lastIndex im Unicode-Modus (u oder v) auf das niedrige Surrogat eines gültigen UTF-16-Surrogatpaars, kann ein Treffer mit y am vorangehenden hohen Surrogat beginnen. Bei Erfolg wird der Index auf die Position direkt nach dem Treffer gesetzt; bei einem Fehlschlag wird er auf null zurückgesetzt, auch wenn er die Stringlänge überschreitet. Auch wenn keines der beiden Flags gesetzt ist, liest der eingebaute Suchalgorithmus lastIndex und wendet ToLength auf den Wert an. Gelingt die Umwandlung, beginnt die Suche bei 0, ohne dass der Algorithmus die Eigenschaft aktualisiert. Ist der Wert ein Symbol, löst die Umwandlung einen TypeError aus, und die Suche beginnt nicht.
Du kannst regexp.lastIndex = index zuweisen; bei der Verwendung wird der Wert mit ToLength umgewandelt. Der Zustand gehört zum regulären Ausdruck, nicht zum String: Setze vor einer unabhängigen Suche lastIndex = 0 oder erstelle eine neue Instanz. Wiederholte Aufrufe von test() mit g oder y ändern den Zustand ebenfalls.
Ein leerer Treffer in exec() erhöht den Index nicht automatisch, sodass eine naive Schleife endlos laufen kann. Das Beispiel verwendet nichtleere Treffer und zeigt den Fortschritt, das Zurücksetzen nach einem Fehlschlag und das manuelle Fortsetzen.
Beispiele
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);Ergebnis
true 1 true 3 false 0 2 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.