TypedArray[Symbol.species]

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

Die [Symbol.species] Accessor-Eigenschaft gibt den Standardkonstruktor für typisierte Array Objekte zurück. Unterklassenkonstruktoren können ihn überschreiben, um die Konstruktorzuweisung zu ändern. Die Standardimplementierung ist im Wesentlichen:

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

Beim Aufrufen von Methoden für typisierte Arrays, die das bestehende Array nicht ändern, sondern eine neue Array-Instanz zurückgeben (zum Beispiel filter() und map()), wird der constructor[Symbol.species] des Arrays aufgerufen. Der zurückgegebene Konstruktor wird verwendet, um den Rückgabewert der Methode des typisierten Arrays zu konstruieren.

Im Gegensatz zu Array[Symbol.species] stellt die Sprache jedoch sicher, dass das neu erstellte Array ein richtig typisiertes Array ist und denselben Inhaltstyp wie das Originalarray hat — zum Beispiel kann man kein BigInt64Array von einem Float64Array erstellen oder ein nicht-BigInt-Array von einem BigInt-Array erstellen. Der Versuch, dies zu tun, führt zu einem TypeError.

class BadArray extends Int8Array {
  static get [Symbol.species]() {
    return Array;
  }
}
new BadArray(1).map(() => 0); // TypeError: Method %TypedArray%.prototype.map called on incompatible receiver [object Array]

class BadArray2 extends Int8Array {
  static get [Symbol.species]() {
    return BigInt64Array;
  }
}
new BadArray2(1).map(() => 0n); // TypeError: TypedArray.prototype.map constructed typed array of different content type from |this|

Die [Symbol.species] Eigenschaft gibt die Standardkonstruktorfunktion zurück, die für jeden gegebenen typisierten Array Konstruktor eine der typisierten Array-Konstruktoren selbst ist.

Int8Array[Symbol.species]; // function Int8Array()
Uint8Array[Symbol.species]; // function Uint8Array()
Float32Array[Symbol.species]; // function Float32Array()

In einer Instanz einer benutzerdefinierten Unterklasse von TypedArray, wie MyTypedArray, ist die Species von MyTypedArray der MyTypedArray Konstruktor. Sie möchten dies jedoch möglicherweise überschreiben, um ein übergeordnetes typisiertes Array Objekt in Ihren Methoden der abgeleiteten Klasse zurückzugeben:

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

• TypedArray
• Symbol.species