KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

RegExp lastIndex — positie van de volgende overeenkomst

lastIndex bewaart de volgende zoekpositie voor reguliere expressies met de vlag g of y. Het is een beschrijfbare eigenschap van elke RegExp-instantie, geen eigenschap van het prototype.

Versie: 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 = index

Ondanks de naam RegExp.prototype.lastIndex is lastIndex een eigen eigenschap van elke RegExp-instantie, met als beginwaarde 0. De eigenschap is beschrijfbaar, niet opsombaar en niet configureerbaar. Posities worden geteld in UTF-16-code-eenheden, niet in tekens zoals mensen die waarnemen.

Bij de ingebouwde methoden exec() en test() is lastIndex het uitgangspunt voor het zoeken met g of y. Met g zonder y is een overeenkomst op een latere positie mogelijk; met y worden geen latere posities geprobeerd. Als lastIndex in Unicode-modus (u of v) naar het lage surrogaat van een geldig UTF-16-surrogaatpaar wijst, kan een overeenkomst met y bij het voorafgaande hoge surrogaat beginnen. Bij succes wordt de index ingesteld direct na de overeenkomst; bij mislukking wordt deze op nul gezet, ook als hij groter is dan de tekenreekslengte. Ook als geen van beide vlaggen is ingesteld, leest het ingebouwde zoekalgoritme lastIndex en past het ToLength toe op die waarde. Als de omzetting slaagt, begint het algoritme bij 0 te zoeken zonder de eigenschap bij te werken. Als de waarde een Symbol is, leidt de omzetting tot een TypeError en begint de zoekactie niet.

Je kunt regexp.lastIndex = index toewijzen; bij gebruik wordt de waarde omgezet met ToLength. De status hoort bij de expressie, niet bij de tekenreeks: stel lastIndex = 0 in of maak een andere instantie voordat je onafhankelijk zoekt. Herhaalde aanroepen van test() met g of y veranderen de status ook.

Een lege overeenkomst in exec() verhoogt de index niet automatisch, waardoor een naïeve lus nooit kan eindigen. Het voorbeeld gebruikt niet-lege overeenkomsten en laat voortgang, terugzetten na mislukking en handmatig hervatten zien.

Voorbeelden

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);

Resultaat

true 1
true 3
false 0
2 3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen