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

Baseline 2025

Neu verfügbar

Seit September 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Ein Modifier überschreibt die Flag-Einstellungen in einem bestimmten Teil eines regulären Ausdrucks. Er kann verwendet werden, um Flags zu aktivieren oder zu deaktivieren, die die Bedeutungen bestimmter Regex-Syntaxelemente ändern. Diese Flags sind i, m und s.

In diesem Artikel

Syntax

regex
(?flags1:pattern)
(?flags1-flags2:pattern)

Hinweis: JavaScript hat nur die "bounded" Modifier-Form, bei der das Muster innerhalb der Modifier-Gruppe platziert wird. Die meisten anderen Sprachen, die Modifier unterstützen, haben eine "unbounded" Form, bei der der Modifier bis zum Ende der am nächsten liegenden umschließenden Gruppe angewendet wird.

Parameter

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.

Beschreibung

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.

Beispiele

Übereinstimmung eines mehrzeiligen Formats nur am Anfang der Zeichenkette

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:

js
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

Bestimmte Wörter ohne Berücksichtigung der Groß-/Kleinschreibung finden

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:

js
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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden