RegExp.prototype.exec()

Probieren Sie es aus

const regex = /fo+/g;
const str = "table football, foosball";
let array;

while ((array = regex.exec(str)) !== null) {
  console.log(`Found ${array[0]}. Next starts at ${regex.lastIndex}.`);
  // Expected output: "Found foo. Next starts at 9."
  // Expected output: "Found foo. Next starts at 19."
}

Syntax

exec(str)

Parameter

str

Der String, gegen den der regulre Ausdruck abgeglichen wird. Alle Werte werden in Strings umgewandelt, daher fhrt das Weglassen oder bergeben von undefined dazu, dass exec() nach dem String "undefined" sucht, was selten gewnscht ist.

Rckgabewert

Wenn der Abgleich fehlschlgt, gibt die exec() Methode null zurck und setzt den lastIndex des Regex auf 0.

Bei erfolgreichem Abgleich gibt die exec() Methode ein Array zurck und aktualisiert die lastIndex Eigenschaft des Regulren Ausdrucksobjekts. Das zurckgegebene Array enthlt den abgeglichenen Text als erstes Element und dann ein Element fr jede erfasste Gruppe des abgeglichenen Textes. Das Array hat auerdem die folgenden zustzlichen Eigenschaften:

index

Der 0-basierte Index des Abgleichs im String.

input

Der Original-String, der abgeglichen wurde.

groups

Ein null-Prototyp-Objekt von benannten Erfassungsgruppen, deren Schlssel die Namen und deren Werte die Erfassungsgruppen sind, oder undefined, wenn keine benannten Erfassungsgruppen definiert wurden. Siehe Erfassungsgruppen fr weitere Informationen.

indices Optional

Diese Eigenschaft ist nur vorhanden, wenn das d Flag gesetzt ist. Es ist ein Array, in dem jeder Eintrag die Grenzen eines Teilstring-Abgleichs darstellt. Der Index jedes Elements in diesem Array entspricht dem Index des jeweiligen Teilstring-Abgleichs im von exec() zurckgegebenen Array. Mit anderen Worten, der erste indices Eintrag reprsentiert den gesamten Abgleich, der zweite indices Eintrag die erste Erfassungsgruppe, usw. Jeder Eintrag selbst ist ein Zwei-Elemente-Array, wobei die erste Zahl den Startindex des Abgleichs und die zweite Zahl dessen Endindex reprsentiert.

Das indices Array hat zustzlich eine groups Eigenschaft, die ein null-Prototyp-Objekt von allen benannten Erfassungsgruppen enthlt. Die Schlssel sind die Namen der Erfassungsgruppen und jeder Wert ist ein Zwei-Elemente-Array, wobei die erste Zahl den Startindex und die zweite Zahl den Endindex der Erfassungsgruppe darstellt. Wenn der regulre Ausdruck keine benannten Erfassungsgruppen enthlt, ist groups undefined.

Beschreibung

JavaScript RegExp Objekte sind zustandsbehaftet, wenn die global oder sticky Flags gesetzt sind (z.B. /foo/g oder /foo/y). Sie speichern einen lastIndex aus dem vorherigen Abgleich. exec() kann intern verwendet werden, um ber mehrere Abgleiche in einem Textstring zu iterieren (mit Erfassungsgruppen), im Gegensatz dazu, nur die bereinstimmenden Strings mit String.prototype.match() zu erhalten.

Wenn exec() verwendet wird, hat das globale Flag keine Auswirkung, wenn das Sticky-Flag gesetzt ist der Abgleich ist immer sticky.

exec() ist die primitive Methode von Regexps. Viele andere Regex-Methoden rufen intern exec() auf einschlielich derjenigen, die von String-Methoden aufgerufen werden, wie [Symbol.replace](). Whrend exec() selbst mchtig ist (und am effizientesten), vermittelt es oft nicht am deutlichsten die Absicht.

• Wenn Sie nur wissen mchten, ob der Regex einen String abgleicht, aber nicht, was tatschlich abgeglichen wird, verwenden Sie RegExp.prototype.test() stattdessen.
• Wenn Sie alle Vorkommen eines globalen Regex finden und sich nicht um Informationen wie Erfassungsgruppen kmmern, verwenden Sie String.prototype.match() stattdessen. Auerdem hilft String.prototype.matchAll(), das bereinstimmen mehrerer Teile eines Strings (mit Erfassungsgruppen) zu vereinfachen, indem Sie ber die Abgleiche iterieren knnen.
• Wenn Sie einen Abgleich ausfhren, um seine Indexposition im String zu finden, verwenden Sie stattdessen die Methode String.prototype.search().

exec() ist ntzlich fr komplexe Operationen, die nicht leicht mit einer der oben genannten Methoden erreicht werden knnen, oft wenn Sie lastIndex manuell anpassen mssen. (String.prototype.matchAll() kopiert den Regex, daher beeinflusst das ndern von lastIndex whrend der Iteration ber matchAll die Iteration nicht.) Fr ein solches Beispiel siehe rewinding lastIndex.

Beispiele

Verwenden von exec()

Betrachten Sie folgendes Beispiel:

// Match "quick brown" followed by "jumps", ignoring characters in between
// Remember "brown" and "jumps"
// Ignore case
const re = /quick\s(?<color>brown).+?(jumps)/dgi;
const result = re.exec("The Quick Brown Fox Jumps Over The Lazy Dog");

Die folgende Tabelle zeigt den Zustand von result nach dem Ausfhren dieses Skripts:

Zustzlich wird re.lastIndex auf 25 gesetzt, da dieser Regex global ist.

Aufeinanderfolgende Abgleiche finden

Wenn Ihr regulrer Ausdruck das g Flag verwendet, knnen Sie die Methode exec() mehrmals ausfhren, um aufeinanderfolgende Abgleiche im selben String zu finden. In diesem Fall beginnt die Suche an dem Teilstring von str, der durch die lastIndex Eigenschaft des regulren Ausdrucks angegeben wird (test() wird auch die lastIndex Eigenschaft voranbringen). Beachten Sie, dass die lastIndex Eigenschaft nicht zurckgesetzt wird, wenn ein anderer String durchsucht wird; die Suche beginnt bei ihrem bestehenden lastIndex.

Zum Beispiel, nehmen Sie folgendes Skript an:

const myRe = /ab*/g;
const str = "abbcdefabh";
let myArray;
while ((myArray = myRe.exec(str)) !== null) {
  let msg = `Found ${myArray[0]}. `;
  msg += `Next match starts at ${myRe.lastIndex}`;
  console.log(msg);
}

Dieses Skript zeigt den folgenden Text an:

Found abb. Next match starts at 3
Found ab. Next match starts at 9

Sie knnen diese Art von Code normalerweise durch String.prototype.matchAll() ersetzen, um ihn weniger fehleranfllig zu machen.

Verwenden von exec() mit RegExp-Literalen

Sie knnen exec() auch verwenden, ohne explizit ein RegExp Objekt zu erstellen:

const matches = /(hello \S+)/.exec("This is a hello world!");
console.log(matches[1]);

Dies wird eine Nachricht mit 'hello world!' protokollieren.

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Regulre Ausdrcke Leitfaden
• RegExp