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