RegExp.prototype.exec()

str

Der String, gegen den der reguläre Ausdruck gematcht werden soll. Alle Werte werden in Strings umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass exec() nach dem String "undefined" sucht, was selten gewünscht ist.

Wenn der Abgleich fehlschlägt, gibt die exec() Methode null zurück und setzt den lastIndex des Regex auf 0.

Wenn der Abgleich erfolgreich ist, gibt die exec() Methode ein Array zurück und aktualisiert die lastIndex Eigenschaft des regulären Ausdruck-Objekts. Das zurückgegebene Array enthält den gematchten Text als erstes Element und dann ein Element für jede erfasste Gruppe des gematchten Textes. Das Array hat auch die folgenden zusätzlichen Eigenschaften:

index

Der 0-basierte Index des Treffers im String.

input

Der ursprüngliche String, gegen den gematcht wurde.

groups

Ein null-Prototyp-Objekt von benannten Erfassungsgruppen, dessen Schlüssel die Namen und Werte die Erfassungsgruppen sind, oder undefined, wenn keine benannten Erfassungsgruppen definiert wurden. Weitere Informationen finden Sie unter Erfassungsgruppen.

indices Optional

Diese Eigenschaft ist nur vorhanden, wenn das d Flag gesetzt ist. Es ist ein Array, bei dem jeder Eintrag die Grenzen eines Substring-Treffers darstellt. Der Index jedes Elements in diesem Array entspricht dem Index des jeweiligen Substring-Treffers im Array, das von exec() zurückgegeben wird. Mit anderen Worten, der erste indices Eintrag repräsentiert den gesamten Treffer, der zweite indices Eintrag die erste Erfassungsgruppe, usw. Jeder Eintrag selbst ist ein Array mit zwei Elementen, wobei die erste Zahl den Startindex und die zweite Zahl das Endindex des Treffers darstellt.

Das indices Array hat zudem eine groups Eigenschaft, die ein null-Prototyp-Objekt aller benannten Erfassungsgruppen hält. Die Schlüssel sind die Namen der Erfassungsgruppen, und jeder Wert ist ein Array mit zwei Elementen, wobei die erste Zahl den Startindex und die zweite Zahl den Endindex der Erfassungsgruppe darstellt. Wenn der reguläre Ausdruck keine benannten Erfassungsgruppen enthält, ist groups undefined.

JavaScript RegExp Objekte sind zustandsbehaftet, wenn sie die global oder sticky Flags gesetzt haben (z.B. /foo/g oder /foo/y). Sie speichern einen lastIndex vom vorherigen Treffer. Mithilfe dessen kann exec() verwendet werden, um über mehrere Treffer in einem Text-String (mit Erfassungsgruppen) zu iterieren, im Gegensatz dazu, nur die übereinstimmenden Strings mit String.prototype.match() zu bekommen.

Beim Verwenden von exec() hat das globale Flag keine Wirkung, wenn das Sticky-Flag gesetzt ist — der Match ist immer sticky.

exec() ist die primitive Methode von Regexps. Viele andere Regexp-Methoden rufen exec() intern auf — auch jene, die von String-Methoden aufgerufen werden, wie [Symbol.replace](). Obwohl exec() selbst mächtig (und die effizienteste Methode) ist, vermittelt es oft nicht am klarsten die Absicht.

• Wenn Sie nur wissen möchten, ob der Regex einen String trifft, aber nicht, was tatsächlich gematcht wird, verwenden Sie stattdessen RegExp.prototype.test().
• Wenn Sie alle Vorkommen eines globalen Regex finden und sich nicht um Informationen wie Erfassungsgruppen kümmern, verwenden Sie stattdessen String.prototype.match(). Darüber hinaus hilft String.prototype.matchAll(), das Matching mehrerer Teile eines Strings (mit Erfassungsgruppen) zu vereinfachen, indem es Ihnen ermöglicht, über die Treffer zu iterieren.
• Wenn Sie eine Übereinstimmung ausführen, um deren Indexposition im String zu finden, verwenden Sie stattdessen die String.prototype.search() Methode.

exec() ist nützlich für komplexe Operationen, die sich nicht einfach über eine der obigen Methoden erreichen lassen, oft wenn Sie lastIndex manuell anpassen müssen. (String.prototype.matchAll() kopiert den Regex, sodass das Ändern von lastIndex beim Iterieren über matchAll die Iteration nicht beeinflusst.) Ein solches Beispiel finden Sie bei rewinding lastIndex.

Betrachten Sie das folgende 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 Ausführen dieses Skripts:

Zusätzlich wird re.lastIndex auf 25 gesetzt, da dieser Regex global ist.

Wenn Ihr regulärer Ausdruck das g Flag verwendet, können Sie die exec() Methode mehrmals verwenden, um aufeinanderfolgende Treffer im gleichen String zu finden. Wenn Sie das tun, beginnt die Suche am Substring von str, der durch die lastIndex Eigenschaft des regulären Ausdrucks angegeben ist (lastIndex (test() wird auch die lastIndex Eigenschaft vorantreiben)). Beachten Sie, dass die lastIndex Eigenschaft nicht zurückgesetzt wird, wenn ein anderer String durchsucht wird, sie startet die Suche an ihrem bestehenden lastIndex.

Zum Beispiel, nehmen Sie an, Sie haben dieses Skript:

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

Normalerweise können Sie diese Art von Code durch String.prototype.matchAll() ersetzen, um es weniger fehleranfällig zu machen.

Sie können 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 protokollieren, die 'hello world!' enthält.

• Reguläre Ausdrücke Leitfaden
• RegExp