Baseline Widely available
Die exec()
Methode von RegExp
Instanzen führt eine Suche mit diesem regulären Ausdruck in einem angegebenen String durch und gibt ein Ergebnis-Array oder null
zurück.
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 Parameter
str
Der String, gegen den der reguläre Ausdruck abgeglichen wird. 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
.
Bei erfolgreichem Abgleich gibt die exec()
Methode ein Array zurück und aktualisiert die lastIndex
Eigenschaft des Regulären Ausdrucksobjekts. Das zurückgegebene Array enthält den abgeglichenen Text als erstes Element und dann ein Element für jede erfasste Gruppe des abgeglichenen Textes. Das Array hat auÃerdem die folgenden zusätzlichen 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 Schlüssel die Namen und deren Werte die Erfassungsgruppen sind, oder undefined
, wenn keine benannten Erfassungsgruppen definiert wurden. Siehe Erfassungsgruppen für 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()
zurückgegebenen Array. Mit anderen Worten, der erste indices
Eintrag repräsentiert 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 repräsentiert.
Das indices
Array hat zusätzlich eine groups
Eigenschaft, die ein null
-Prototyp-Objekt von allen benannten Erfassungsgruppen enthält. Die Schlüssel 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 reguläre Ausdruck keine benannten Erfassungsgruppen enthält, ist groups
undefined
.
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 â einschlieÃlich derjenigen, die von String-Methoden aufgerufen werden, wie [Symbol.replace]()
. Während exec()
selbst mächtig ist (und am effizientesten), vermittelt es oft nicht am deutlichsten die Absicht.
RegExp.prototype.test()
stattdessen.String.prototype.match()
stattdessen. AuÃerdem hilft String.prototype.matchAll()
, das Ãbereinstimmen mehrerer Teile eines Strings (mit Erfassungsgruppen) zu vereinfachen, indem Sie über die Abgleiche iterieren können.String.prototype.search()
.exec()
ist nützlich für komplexe Operationen, die nicht leicht mit einer der oben genannten Methoden erreicht werden können, oft wenn Sie lastIndex
manuell anpassen müssen. (String.prototype.matchAll()
kopiert den Regex, daher beeinflusst das Ãndern von lastIndex
während der Iteration über matchAll
die Iteration nicht.) Für ein solches Beispiel siehe rewinding lastIndex
.
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 Ausführen dieses Skripts:
[0]
"Quick Brown Fox Jumps"
[1]
"Brown"
[2]
"Jumps"
index
4
indices
[[4, 25], [10, 15], [20, 25]]
groups: { color: [10, 15 ]}
input
"The Quick Brown Fox Jumps Over The Lazy Dog"
groups
{ color: "Brown" }
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 Methode exec()
mehrmals ausführen, 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 regulären Ausdrucks angegeben wird (test()
wird auch die lastIndex
Eigenschaft voranbringen). Beachten Sie, dass die lastIndex
Eigenschaft nicht zurückgesetzt 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
Warnung: Es gibt viele Fallstricke, die dazu führen können, dass dies zu einer Endlosschleife wird!
RegExp
Konstruktor) nicht in der while
Bedingung â es wird den Regex bei jeder Iteration neu erstellen und lastIndex
zurücksetzen.g
) Flag gesetzt ist, oder lastIndex
wird niemals vorangebracht./^/gm
), erhöhen Sie dessen lastIndex
manuell bei jedem Mal, um nicht an derselben Stelle festzuhängen.Sie können diese Art von Code normalerweise durch String.prototype.matchAll()
ersetzen, um ihn 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 mit 'hello world!'
protokollieren.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4