RegExp[Symbol.species]
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die statische Zugriffseigenschaft RegExp[Symbol.species]
gibt den Konstruktor zurück, der zum Erstellen kopierter regulärer Ausdrücke in bestimmten RegExp
-Methoden verwendet wird.
Warnung:
Die Existenz von [Symbol.species]
ermöglicht die Ausführung von beliebigem Code und kann Sicherheitsrisiken schaffen. Sie erschwert auch bestimmte Optimierungen erheblich. Entwickler von Engines untersuchen, ob diese Funktion entfernt werden soll. Vermeiden Sie es, wenn möglich, sich darauf zu verlassen.
Syntax
RegExp[Symbol.species]
Rückgabewert
Der Wert des Konstruktors (this
), auf dem get [Symbol.species]
aufgerufen wurde. Der Rückgabewert wird verwendet, um kopierte RegExp
-Instanzen zu erstellen.
Beschreibung
Die Zugriffs-Eigenschaft [Symbol.species]
gibt den Standardkonstruktor für RegExp
-Objekte zurück. Konstruktoren von Unterklassen können sie überschreiben, um die Zuweisung des Konstruktors zu ändern. Die Standardimplementierung ist im Wesentlichen:
// Hypothetical underlying implementation for illustration
class RegExp {
static get [Symbol.species]() {
return this;
}
}
Aufgrund dieser polymorphen Implementierung würde [Symbol.species]
von abgeleiteten Unterklassen standardmäßig auch den Konstruktor selbst zurückgeben.
class SubRegExp extends SubRegExp {}
SubRegExp[Symbol.species] === SubRegExp; // true
Einige RegExp
-Methoden erstellen eine Kopie der aktuellen Regex-Instanz, bevor exec()
ausgeführt wird, so dass Seiteneffekte wie Änderungen an lastIndex
nicht beibehalten werden. Die [Symbol.species]
-Eigenschaft wird verwendet, um den Konstruktor der neuen Instanz zu bestimmen. Die Methoden, die die aktuelle Regex-Instanz kopieren, sind:
Beispiele
Species in gewöhnlichen Objekten
Die [Symbol.species]
-Eigenschaft gibt die Standardkonstruktorfunktion zurück, die der RegExp
-Konstruktor für RegExp
-Objekte ist:
RegExp[Symbol.species]; // function RegExp()
Species in abgeleiteten Objekten
In einer Instanz einer benutzerdefinierten RegExp
-Unterklasse, wie MyRegExp
, ist die MyRegExp
-Species der MyRegExp
-Konstruktor. Sie möchten dies jedoch möglicherweise überschreiben, um übergeordnete RegExp
-Objekte in Ihren abgeleiteten Klassenmethoden zurückzugeben:
class MyRegExp extends RegExp {
// Overwrite MyRegExp species to the parent RegExp constructor
static get [Symbol.species]() {
return RegExp;
}
}
Oder Sie können dies verwenden, um den Kopiervorgang zu beobachten:
class MyRegExp extends RegExp {
constructor(...args) {
console.log("Creating a new MyRegExp instance with args:", args);
super(...args);
}
static get [Symbol.species]() {
console.log("Copying MyRegExp");
return this;
}
exec(value) {
console.log("Executing with lastIndex:", this.lastIndex);
return super.exec(value);
}
}
Array.from("aabbccdd".matchAll(new MyRegExp("[ac]", "g")));
// Creating a new MyRegExp instance with args: [ '[ac]', 'g' ]
// Copying MyRegExp
// Creating a new MyRegExp instance with args: [ MyRegExp /[ac]/g, 'g' ]
// Executing with lastIndex: 0
// Executing with lastIndex: 1
// Executing with lastIndex: 2
// Executing with lastIndex: 5
// Executing with lastIndex: 6
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-get-regexp-%symbol.species% |