WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Flags für reguläre Ausdrücke: dotAll (`s`), `u`, `i` und `g`

Die Flags `s`, `u`, `i` und `g` steuern Zeilenumbrüche beim Punkt, den Unicode-Modus, die Behandlung der Groß- und Kleinschreibung und die globale Suche.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

/pattern/gsui
new RegExp("pattern", "gsui")
re.dotAll; re.unicode; re.ignoreCase; re.global; re.lastIndex

Flags stehen hinter dem schließenden Schrägstrich eines Literals (/a.b/gsui) oder im zweiten Argument des Konstruktors (new RegExp("a.b", "gsui")). Ihre Reihenfolge spielt keine Rolle; ein unbekanntes oder doppeltes Flag verursacht einen SyntaxError. Die Eigenschaften dotAll, unicode, ignoreCase und global zeigen an, ob s, u, i und g gesetzt sind; sie ändern die Flags nicht. Diese Regeln gelten in ECMAScript 2024, die Unterstützung hängt aber von der Laufzeitumgebung ab.

Mit s (dotAll) erfasst das Platzhalterzeichen . auch die vier Zeilenabschlusszeichen \n, \r, U+2028 und U+2029. Das ändert die Anker ^ und $ nicht; erst mit m passen sie auch auf Zeilengrenzen. \. steht weiterhin für einen wörtlichen Punkt.

u aktiviert den Unicode-Modus: Ein Punkt behandelt ein gültiges Surrogatpaar wie 😄 als einen Codepunkt statt als zwei UTF-16-Codeeinheiten. Ein Codepunkt ist nicht unbedingt ein ganzes Graphem, also ein als Einheit wahrgenommenes Zeichen. u verschärft außerdem die Syntaxregeln und ist nicht mit v kombinierbar (SyntaxError). i ignoriert Groß- und Kleinschreibung; zusammen mit u verwendet es einfaches Unicode Case Folding, unabhängig von der Spracheinstellung und ohne ß zu ss zu erweitern.

g ermöglicht die Iteration über nicht überlappende Treffer. Mit g und ohne y verwendet das eingebaute exec() lastIndex als UTF-16-Offset, um den Suchbeginn zu bestimmen. Liegt dieser Offset im Unicode-Modus innerhalb eines gültigen Surrogatpaars, kann ein Treffer am Anfang des Paars und damit vor lastIndex beginnen. Bei einem Treffer speichert exec() das Trefferende als UTF-16-Offset in lastIndex; bei einem Fehlschlag setzt es lastIndex auf 0. Auch test() kann diesen Zustand ändern. Für eine unabhängige Suche setze lastIndex zurück oder verwende ein neues RegExp-Objekt. Ein leerer Treffer kann eine exec()-Schleife blockieren. String.prototype.matchAll() verlangt für ein RegExp-Argument das Flag g (sonst TypeError), rückt nach leeren Treffern weiter und iteriert auf einer Kopie, deren lastIndex mit dem aktuellen lastIndex des Originals initialisiert wird.

Beispiele

{
  const text = "a\nb A😄b";
  const re = /a.b/gsui;
  const collect = (pattern) => Array.from(text.matchAll(pattern), (m) => m[0]);

  console.log(JSON.stringify(collect(re)));
  console.log(JSON.stringify([/a.b/gui, /a.b/gsi, /a.b/gsu].map(collect)));

  const positions = [];
  for (let n = 0; n < 3; n++) {
    re.exec(text);
    positions.push(re.lastIndex);
  }
  console.log(JSON.stringify(positions));
}

Ergebnis

["a\nb","A😄b"]
[["A😄b"],["a\nb"],["a\nb"]]
[3,8,0]

Die erste Zeile zeigt beide Treffer. In der zweiten fehlt jeweils `s`, `u` oder `i` aus dem vollständigen Satz: Dadurch entfällt der Treffer über den Zeilenumbruch, mit dem Emoji oder mit dem Großbuchstaben. Die dritte Zeile zeigt `lastIndex` nach zwei Treffern und einem Fehlschlag.

Zugehörige Lektionen

  • JavaScript · Lektion 10 · Fortgeschritten · Version: 4

Quellen