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 Zugriffseigenschaft [Symbol.species] gibt den Standardkonstruktor für RegExp-Objekte zurück. Unterklassen-Konstruktoren können diese überschreiben, um die Konstruktorzuordnung zu ändern. Die Standardimplementierung sieht im Wesentlichen so aus:

// Hypothetical underlying implementation for illustration
class RegExp {
  static get [Symbol.species]() {
    return this;
  }
}

Aufgrund dieser polymorphen Implementierung würde [Symbol.species] von abgeleiteten Unterklassen auch standardmäßig 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 sie exec() ausführen, um zu verhindern, dass Seiteneffekte wie Änderungen an lastIndex 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:

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

Die [Symbol.species]-Eigenschaft gibt die Standard-Konstruktorfunktion zurück, bei RegExp-Objekten ist dies der RegExp-Konstruktor:

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

In einer Instanz einer benutzerdefinierten RegExp-Unterklasse, wie MyRegExp, ist das Species von MyRegExp der MyRegExp-Konstruktor. Vielleicht möchten Sie dies jedoch überschreiben, 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 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