Array[Symbol.species]

Der Wert des Konstruktors (this), auf dem get [Symbol.species] aufgerufen wurde. Der Rückgabewert wird verwendet, um Rückgabewerte aus Array-Methoden zu konstruieren, die neue Arrays erstellen.

Die [Symbol.species] Zugriffs-eigenschaft gibt den Standardkonstruktor für Array-Objekte zurück. Unterklassenkonstruktoren können sie überschreiben, um die Zuweisung des Konstruktors zu ändern. Die Standardimplementierung ist im Wesentlichen:

// Hypothetical underlying implementation for illustration
class Array {
  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 SubArray extends Array {}
SubArray[Symbol.species] === SubArray; // true

Wenn Array-Methoden aufgerufen werden, die das bestehende Array nicht ändern, sondern eine neue Array-Instanz zurückgeben (zum Beispiel filter() und map()), wird auf den constructor[Symbol.species] des Arrays zugegriffen. Der zurückgegebene Konstruktor wird verwendet, um den Rückgabewert der Array-Methode zu konstruieren. Es ist damit technisch möglich, dass Array-Methoden Objekte zurückgeben, die nicht mit Arrays verwandt sind.

class NotAnArray {
  constructor(length) {
    this.length = length;
  }
}

const arr = [0, 1, 2];
arr.constructor = { [Symbol.species]: NotAnArray };
arr.map((i) => i); // NotAnArray { '0': 0, '1': 1, '2': 2, length: 3 }
arr.filter((i) => i); // NotAnArray { '0': 1, '1': 2, length: 0 }
arr.concat([1, 2]); // NotAnArray { '0': 0, '1': 1, '2': 2, '3': 1, '4': 2, length: 5 }

Die [Symbol.species]-Eigenschaft gibt die Standard-Konstruktorfunktion zurück, die der Array-Konstruktor für Array ist.

Array[Symbol.species]; // [Function: Array]

In einer Instanz einer benutzerdefinierten Array-Unterklasse, wie MyArray, ist die MyArray-Species der MyArray-Konstruktor. Sie möchten dies jedoch möglicherweise überschreiben, um Eltern-Array-Objekte in Ihren Methoden der abgeleiteten Klasse zurückzugeben:

class MyArray extends Array {
  // Overwrite MyArray species to the parent Array constructor
  static get [Symbol.species]() {
    return Array;
  }
}

• Polyfill von Array[Symbol.species] und Unterstützung von [Symbol.species] in allen betroffenen Array-Methoden in core-js
• Indizierte Sammlungen Leitfaden
• Array
• Symbol.species