CKTIS / JavaScript
RegExp.prototype.exec — Treffer und Erfassungsgruppen
RegExp.prototype.exec sucht nach einem Treffer und gibt ein Array mit dem gefundenen Text und den Erfassungen oder null zurück. Mit den Flags g und y verwenden aufeinanderfolgende Aufrufe lastIndex und aktualisieren diesen Wert.
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.exec(string)regexp.exec(string) führt einen regulären Ausdruck aus. Das Argument wird in einen String umgewandelt; die eingebaute Methode erfordert als this eine tatsächliche RegExp-Instanz. Das Ergebnis ist ein Array oder null, kein boolescher Wert. Prüfe das Ergebnis, bevor du seine Eigenschaften ausliest.
match[0] enthält den vollständigen Treffer, match[1] und die folgenden Elemente enthalten die Erfassungsgruppen. Eine Gruppe, die nicht am Treffer beteiligt war, ergibt undefined. match.index ist die Startposition in UTF-16-Codeeinheiten, und match.input ist der durchsuchte String. Das Flag d stellt zusätzlich match.indices mit Start-/Endpaaren bereit; das Ende ist exklusiv. match.groups enthält benannte Gruppen oder undefined, wenn das Muster keine hat.
Ohne g oder y beginnt die Suche an Position 0 und lässt lastIndex unverändert. Ist eines dieser Flags gesetzt, dient das Ergebnis von ToLength auf lastIndex als Ausgangsposition für die Suche (zum Beispiel wird aus 1.9 der Wert 1). Mit g, aber ohne y, kann die Suche nach einem fehlgeschlagenen Versuch spätere Positionen prüfen; mit y prüft sie keine späteren Positionen. Zeigt der umgewandelte Wert von lastIndex im Unicode-Modus (u oder v) auf die zweite Codeeinheit eines UTF-16-Surrogatpaars, kann ein Treffer an der ersten Codeeinheit dieses Paars beginnen. Daher muss der ausgegebene Wert von match.index selbst mit y nicht dem umgewandelten Wert von lastIndex entsprechen. Bei Erfolg wird lastIndex auf das Ende des Treffers gesetzt, bei einem Fehlschlag auf null zurückgesetzt. Setze vor einer unabhängigen Suche mit demselben Objekt lastIndex = 0.
Verwende in einer Schleife dasselbe RegExp-Objekt. Achtung: Bei einem leeren Treffer wird lastIndex nicht automatisch weitergesetzt; ohne explizites Weiterrücken oder einen Abbruch endet die Schleife möglicherweise nie. Das Beispiel verwendet ein Muster, das immer mindestens ein Zeichen trifft, und zeigt das Zurücksetzen nach dem letzten Fehlschlag.
Beispiele
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);Ergebnis
["x=12","x","12",0,4] ["y=7","y","7",5,8] 0
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.