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 September 2016.
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:
Das Vorhandensein von [Symbol.species] ermöglicht die Ausführung von beliebigem Code und kann Sicherheitslücken schaffen. Es macht auch bestimmte Optimierungen viel schwieriger. Die Entwickler von Engines untersuchen, ob dieses Feature entfernt werden soll. Vermeiden Sie es, sich darauf zu verlassen, wenn möglich.
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 Zugriffseigenschaft [Symbol.species] gibt den Standardkonstruktor für RegExp-Objekte zurück. Unterklasse-Konstruktoren können dies ü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 RegExp {}
SubRegExp[Symbol.species] === SubRegExp; // true
Einige RegExp-Methoden erstellen eine Kopie der aktuellen Regex-Instanz, bevor exec() ausgeführt wird, damit Nebeneffekte wie Änderungen an lastIndex nicht erhalten bleiben. Die Eigenschaft [Symbol.species] 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 Eigenschaft [Symbol.species] gibt die Standardkonstrukturfunktion 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 Spezies MyRegExp der MyRegExp-Konstruktor. Sie könnten dies jedoch überschreiben wollen, um in Ihren abgeleiteten Klassenmethoden Eltern-RegExp-Objekte 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 nutzen, 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® 2026 Language Specification # sec-get-regexp-%symbol.species% |
Browser-Kompatibilität
Loading…