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.lastIndexFlags 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