WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

RegExp.prototype.flags — Flags regulärer Ausdrücke auslesen

Die Eigenschaft flags gibt die Flags eines regulären Ausdrucks als Zeichenfolge in einer festen Reihenfolge zurück, unabhängig von ihrer Reihenfolge bei der Erstellung. Sie ist ein Accessor ohne Setter und keine Methode.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

regexp.flags

RegExp.prototype.flags ist eine Accessor-Eigenschaft, die mit regexp.flags und ohne Aufrufklammern gelesen wird. Sie gibt eine Zeichenfolge mit den aktivierten Flags zurück; wenn keine aktiviert sind, ist das Ergebnis die leere Zeichenfolge "". Das Muster und die umgebenden Schrägstriche werden nicht zurückgegeben.

Die Buchstaben werden in der festen Reihenfolge dgimsuvy zurückgegeben; deaktivierte Flags werden ausgelassen. Die Reihenfolge entspricht also nicht der Schreibweise bei der Erstellung. Der Getter liest nacheinander die Eigenschaften hasIndices, global, ignoreCase, multiline, dotAll, unicode, unicodeSets und sticky, die diesen Buchstaben entsprechen. Die gelesenen Werte werden in boolesche Werte umgewandelt. Dass flags unterstützt wird, bedeutet nicht, dass eine bestimmte Engine auch jedes der neueren Flags unterstützt.

Der Accessor hat keinen Setter: Eine Zuweisung an regexp.flags ändert die Flags des Ausdrucks nicht; bei einer gewöhnlichen Instanz im Strict Mode wird ein TypeError ausgelöst. Um andere Flags zu verwenden, erstelle einen neuen Ausdruck, zum Beispiel new RegExp(regexp.source, "g"). Der Getter liest öffentliche Eigenschaften. Werden diese überschrieben, kann sich der angezeigte Wert ändern, ohne dass sich das Matching-Verhalten ändert.

Das Beispiel zeigt die Normalisierung der Reihenfolge: /cat/mi gibt im zurück. JSON.stringify macht die für /cat/ zurückgegebene leere Zeichenfolge als "" sichtbar.

Beispiele

const regexp = /cat/mi;
console.log(regexp.flags);
console.log(JSON.stringify(/cat/.flags));

Ergebnis

im
""

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen