CKTIS / JavaScript
RegExp.prototype.exec — overeenkomsten en capturegroepen
RegExp.prototype.exec zoekt naar een overeenkomst en geeft een array met de overeenkomende tekst en captures terug, of null. De vlaggen g en y zorgen ervoor dat opeenvolgende aanroepen lastIndex gebruiken en bijwerken.
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.exec(string)regexp.exec(string) voert een reguliere-expressiematch uit. Het argument wordt omgezet naar een tekenreeks; de ingebouwde methode vereist een echte RegExp-instantie als this. Het resultaat is een array of null, geen booleaanse waarde. Controleer het resultaat voordat je de eigenschappen ervan leest.
match[0] bevat de volledige overeenkomst; match[1] en de volgende elementen bevatten de capturegroepen. Een groep die niet aan de overeenkomst heeft deelgenomen, levert undefined op. match.index is de beginpositie in UTF-16-code-eenheden, en match.input is de doorzochte tekenreeks. match.groups bevat benoemde groepen, of undefined als het patroon die niet heeft. De vlag d maakt ook match.indices beschikbaar met begin-/eindparen; het eindpunt is exclusief.
Zonder g of y begint de zoekactie op positie 0 en blijft lastIndex ongewijzigd. Als minstens één van deze vlaggen is ingesteld, gebruikt de zoekactie het resultaat van ToLength op lastIndex als uitgangspositie (zo wordt 1.9 bijvoorbeeld 1). Met g maar zonder y kan de zoekactie na een mislukte poging latere posities proberen; met y doet ze dat niet. Als de omgezette waarde van lastIndex in Unicode-modus (u of v) naar de tweede code-eenheid van een UTF-16-surrogaatpaar wijst, kan een overeenkomst beginnen bij de eerste code-eenheid van dat paar. Daardoor hoeft de gerapporteerde match.index zelfs met y niet gelijk te zijn aan de omgezette waarde van lastIndex. Bij succes wordt lastIndex ingesteld op het einde van de overeenkomst; bij mislukking wordt het op nul gezet. Stel lastIndex = 0 in voordat je hetzelfde object opnieuw gebruikt voor een onafhankelijke zoekactie.
Gebruik in een lus steeds hetzelfde RegExp-object. Let op: een lege overeenkomst laat lastIndex niet automatisch opschuiven; zonder de index expliciet te verhogen of de lus af te breken, eindigt de lus mogelijk nooit. Het voorbeeld gebruikt een patroon dat altijd met minstens één teken overeenkomt en laat zien dat de index na de laatste mislukking wordt teruggezet.
Voorbeelden
const regexp = /([a-z]+)=(\d+)/g;
const text = "x=12 y=7";
let match;
while ((match = regexp.exec(text)) !== null) {
console.log(JSON.stringify([match[0], match[1], match[2], match.index, regexp.lastIndex]));
}
console.log(regexp.lastIndex);Resultaat
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
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.