WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

RegExp.prototype.source — Text des regulären Ausdrucksmusters

Die Eigenschaft source gibt den Text eines RegExp-Musters ohne umgebende Schrägstriche oder Flags zurück. Damit lässt sich ein Muster auslesen oder mit new RegExp() rekonstruieren, wobei die Flags separat übergeben werden.

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

RegExp.prototype.source ist eine Accessor-Eigenschaft mit Getter, aber ohne Setter. Lies sie als regexp.source, ohne Aufrufklammern. Das Ergebnis ist ein String mit dem Muster, jedoch ohne umgebende /-Trennzeichen und ohne Flags. Die Flags lassen sich separat über regexp.flags auslesen.

Das Ergebnis eignet sich dazu, das Muster innerhalb eines regulären Ausdrucksliterals darzustellen: Schrägstriche und Zeilenabschlusszeichen werden passend maskiert. Es muss daher nicht mit dem an den Konstruktor übergebenen Text identisch sein. Für ein leeres Muster gibt new RegExp("").source "(?:)" und keinen leeren String zurück. Auch das Auslesen von RegExp.prototype.source selbst ergibt "(?:)".

Um das Muster und seine Flags zu rekonstruieren, verwende new RegExp(regexp.source, regexp.flags). Dabei entsteht ein neues Objekt; der Zustand von lastIndex wird nicht kopiert. source macht beliebigen Text nicht zu einem sicheren literalen Muster — vorhandene Operatoren für reguläre Ausdrücke behalten ihre Bedeutung.

Der Getter erfordert ein tatsächliches RegExp-Objekt; RegExp.prototype selbst ist eine besondere Ausnahme. Wird der Getter mit einem anderen Empfänger aufgerufen, wird ein TypeError ausgelöst. Eine Zuweisung an die gewöhnliche geerbte Eigenschaft source ändert das Muster nicht: Im Strict Mode wird ein TypeError ausgelöst, andernfalls wird die Zuweisung ignoriert.

Beispiele

const pattern = /a\/b+/gi;
const copy = new RegExp(pattern.source, pattern.flags);

console.log(pattern.source);
console.log(pattern.flags);
console.log(copy.test("A/BBB"));
console.log(new RegExp("").source);

Ergebnis

a\/b+
gi
true
(?:)

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