Modifier: (?ims-ims:...)

flags1 Optional

Eine Zeichenkette von Flags, die aktiviert werden sollen. Kann jede Kombination von i, m und s enthalten.

flags2 Optional

Eine Zeichenkette von Flags, die deaktiviert werden sollen. Kann jede Kombination von i, m und s enthalten, darf jedoch keine Flags enthalten, die in flags1 enthalten sind.

pattern

Ein Muster, das alles enthält, was Sie in einem Regex-Literal verwenden können, einschließlich einer Disjunction.

Einige Flags ändern die Bedeutungen von Regex-Syntaxelementen:

• Das i-Flag macht den Regex durch alle Literalzeichen und Zeichenklassen implizit in Kleinbuchstaben zu deklariertem insensitive.
• Das m-Flag ändert das Verhalten von Eingabegrenzen-Assertions ^ und $, um den Anfang und das Ende jeder Zeile sowie den Anfang und das Ende der Eingabezeichenkette zu erfassen.
• Das s-Flag ändert das Verhalten des Wildcard-Zeichens . so, dass es jedes Zeichen einschließlich Zeilenendzeichen erfasst.

Manchmal möchten Sie, dass diese Änderungen nur in einem bestimmten Teil eines Regex-Musters wirksam werden. Sie können dies tun, indem Sie diesen Teil in einen Modifier einschließen. Zum Beispiel:

/(?i:Hello) world/;

In diesem Regex ist das i-Flag nur für den Hello-Teil des Musters aktiviert. Der world-Teil ist groß-/klein-schreibungssensitiv. Daher passt es zu Hello world, hello world und HELLO world, aber nicht zu HELLO WORLD. Das Folgende ist gleichwertig, indem das i-Flag global aktiviert und dann für den world-Teil deaktiviert wird:

/Hello (?-i:world)/i;

Die Parameter flags1 und flags2 können jede Kombination von i, m und s enthalten. Die Flags müssen jedoch eineindeutig zwischen flags1 und flags2 sein — Sie können ein Flag nicht doppelt aktivieren oder deaktivieren oder ein Flag aktivieren und dann sofort deaktivieren.

Die Parameter flags1 und flags2 sind optional, aber mindestens einer muss nicht leer sein. (?flags1-:pattern) ist ein Modifier, der nur Flags aktiviert (äquivalent zu (?flags1:pattern)). (?-flags2:pattern) ist ein Modifier, der nur Flags deaktiviert. (?:pattern) ist nur eine nicht-erfassende Gruppe, und (?-:pattern) ist ein Syntaxfehler.

Andere Flags sind in einem Modifier unsinnig und führen zu Syntaxfehlern, wenn sie eingeschlossen werden:

• Die Flags g und y bestimmen das Verhalten mehrerer Aufrufe von exec() und beeinflussen das Übereinstimmungsverhalten des gesamten Regex.
• Das d-Flag aktiviert zusätzliche Informationen im exec()-Ergebnis und beeinflusst das Übereinstimmungsverhalten des gesamten Regex.
• Die Flags u und v ändern das Verhalten der Regex-Engine auf eine Weise, die zu komplex ist, um lokal modifiziert zu werden. Sie haben auch globale Auswirkungen auf den Regex, wie das Fortschreiten des lastIndex.

Der folgende Regex definiert ein Format für eine mehrzeilige Zeichenkette. Das erste ^ stellt den Anfang der gesamten Eingabezeichenkette dar, indem es sich innerhalb eines (?-m:)-Modifiers befindet, während alle anderen ^-Zeichen den Anfang einer Zeile darstellen:

const pattern = /(?-m:^)---\n^title:.*^slug:.*^---/ms;

const input = `---
title: "Modifier: (?ims-ims:...)"
slug: Web/JavaScript/Reference/Regular_expressions/Modifier
---`;

pattern.test(input); // true

// Extra line break at the start of string
const input2 = `\n${input}`;

pattern.test(input2); // false

Stellen Sie sich vor, Sie suchen alle Variablendeklarationen, die foo oder bar heißen (da sie schlechte Namen sind). Das Wort kann in beliebiger Groß-/Kleinschreibung erscheinen, aber Sie wissen, dass das Schlüsselwort immer in Kleinbuchstaben ist, also können Sie das tun:

const pattern = /(?:var|let|const) (?i:foo|bar)\b/;

pattern.test("let foo;"); // true
pattern.test("const BAR = 1;"); // true
pattern.test("Let foo be a number"); // false

• Gruppen und Rückverweise Leitfaden
• Reguläre Ausdrücke
• Nicht-erfassende Gruppe: (?:...)