RegExp() Konstruktor

Probieren Sie es aus

Syntax

Parameter

Der Text des regulären Ausdrucks. Dies kann auch ein anderes RegExp-Objekt sein.

Wenn angegeben, ist flags ein String, der die hinzuzufügenden Flags enthält. Alternativ ersetzt der flags-String alle Flags des gelieferten RegExp-Objekts als pattern (und lastIndex wird auf 0 zurückgesetzt).

flags kann eine beliebige Kombination der folgenden Zeichen enthalten:

Erzeugt Indizes für Teilstring-Übereinstimmungen.

Findet alle Übereinstimmungen anstelle des Stopps nach der ersten Übereinstimmung.

Unterschiede in der Groß-/Kleinschreibung werden beim Abgleich ignoriert.

Behandelt Anfangs- und Endprüfungen (^ und $) als über mehrere Zeilen hinweg wirkend. Anders ausgedrückt, es wird der Anfang oder das Ende jeder Zeile (durch \n oder \r begrenzt) abgeglichen, nicht nur der sehr Anfang oder das Ende der gesamten Eingabe.

Erlaubt es . Zeilenumbrüche zu matchen.

Behandelt pattern als eine Folge von Unicode-Codepunkte.

Ein Upgrade des u-Flags, das Set-Notation in Zeichenklassen sowie Zeichenketteneigenschaften ermöglicht.

Passt nur ab dem durch die lastIndex-Eigenschaft dieses regulären Ausdrucks im Zielstring angegebenen Index. Versucht nicht, von späteren Indizes aus abzugleichen.

Rückgabewert

RegExp(pattern) gibt pattern direkt zurück, wenn alle folgenden Bedingungen zutreffen:

• RegExp() wird ohne new aufgerufen;
• pattern ist ein Regex;
• pattern.constructor === RegExp (meistens bedeutet dies, dass es keine Unterklasse ist);
• flags ist undefined.

In allen anderen Fällen erzeugt der Aufruf von RegExp() mit oder ohne new ein neues RegExp-Objekt. Wenn pattern ein Regex ist, ist die source des neuen Objekts pattern.source; andernfalls ist seine Quelle pattern in einen String umgewandelt. Wenn der flags-Parameter nicht undefined ist, ist das neue Objekt flags der Wert des Parameters; andernfalls ist flags des Objekts pattern.flags (falls pattern ein Regex ist).

Ausnahmen

Wird in einer der folgenden Fälle ausgelöst:

• pattern kann nicht als gültiger regulärer Ausdruck analysiert werden.
• flags enthält wiederholte Zeichen oder ein nicht erlaubtes Zeichen.

Beispiele

Literale Notation und Konstruktor

Es gibt zwei Möglichkeiten, ein RegExp-Objekt zu erstellen: eine literale Notation und einen Konstruktor.

• Die literale Notation nimmt ein Muster zwischen zwei Schrägstrichen, gefolgt von optionalen Flags, nach dem zweiten Schrägstrich.
• Die Konstruierungsfunktion nimmt entweder einen String oder ein RegExp-Objekt als ersten Parameter und einen String von optionalen Flags als zweiten Parameter.

Die folgenden drei Ausdrücke erstellen den gleichen regulären Ausdruck:

Bevor reguläre Ausdrücke verwendet werden können, müssen sie kompiliert werden. Dieser Prozess ermöglicht es ihnen, effizienter Übereinstimmungen zu erzielen. Es gibt zwei Möglichkeiten, ein RegExp-Objekt zu kompilieren und zu erhalten.

Die literale Notation führt zur Kompilierung des regulären Ausdrucks, wenn der Ausdruck ausgewertet wird. Andererseits führt der Konstruktor des RegExp-Objekts, new RegExp('ab+c'), zur Laufzeitkompilierung des regulären Ausdrucks.

Verwenden Sie einen String als das erste Argument des RegExp()-Konstruktors, wenn Sie den regulären Ausdruck aus dynamischen Eingaben erstellen möchten.

Erstellen eines regulären Ausdrucks aus dynamischen Eingaben

Spezifikationen

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

• Polyfill vieler moderner RegExp-Funktionen (dotAll, sticky Flags, benannte Erfassungsgruppen etc.) in core-js
• Leitfaden zu regulären Ausdrücken
• String.prototype.match()
• String.prototype.replace()