RegExp[Symbol.species]

Der Wert des Konstruktors (this), auf dem get [Symbol.species] aufgerufen wurde. Der Rückgabewert wird verwendet, um kopierte RegExp-Instanzen zu erstellen.

Die [Symbol.species] Accessor-Eigenschaft gibt den Standardkonstruktor für RegExp-Objekte zurück. Unterklassige Konstruktoren können ihn ü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 ebenfalls 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, damit Seiteneffekte wie Änderungen an lastIndex nicht erhalten bleiben. Die [Symbol.species]-Eigenschaft wird verwendet, um den Konstruktor der neuen Instanz zu bestimmen. Die Methoden, die die aktuelle Regex-Instanz kopieren, sind:

• [Symbol.matchAll]()
• [Symbol.split]()

Die [Symbol.species]-Eigenschaft gibt die Standardkonstruktorfunktion zurück, die der RegExp-Konstruktor für RegExp-Objekte ist:

RegExp[Symbol.species]; // function RegExp()

In einer Instanz einer benutzerdefinierten RegExp-Unterklasse, wie MyRegExp, ist die MyRegExp-Species der MyRegExp-Konstruktor. Sie könnten jedoch möchten, dies zu ü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

• RegExp
• Symbol.species