TypedArray[Symbol.species]

Статическое свойство-аксессор TypedArray[Symbol.species] возвращает конструктор, используемый для создания возвращаемых значений из методов типизированных массивов.

Синтаксис

TypedArray[Symbol.species]

Возвращаемое значение

Значение конструктора (this), на котором был вызван get [Symbol.species]. Возвращаемое значение используется для создания возвращаемых значений из методов типизированных массивов, которые создают новые типизированные массивы.

Описание

Свойство-аксессор [Symbol.species] возвращает конструктор по умолчанию для объектов типизированного массива. Конструкторы подклассов могут переопределить его, чтобы изменить назначение конструктора. Реализация по умолчанию выглядит следующим образом:

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

Благодаря этой полиморфной реализации, [Symbol.species] производных подклассов также по умолчанию возвращает сам конструктор.

class SubTypedArray extends Int8Array {}
SubTypedArray[Symbol.species] === SubTypedArray; // true

При вызове методов типизированного массива, которые не изменяют существующий массив, но возвращают новый экземпляр массива (например, filter() и map()), будет доступен constructor[Symbol.species] массива. Возвращенный конструктор будет использоваться для создания возвращаемого значения метода типизированного массива.

Однако, в отличие от Array[Symbol.species], при использовании [Symbol.species] для создания новых типизированных массивов, язык гарантирует, что вновь созданный массив является надлежащим типизированным массивом и имеет тот же тип содержимого, что и исходный массив — например, нельзя создать BigInt64Array из Float64Array или создать массив, не являющийся BigInt, из массива BigInt. При попытке сделать это выбрасывается 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|

Примеры

Species в обычных объектах

Свойство [Symbol.species] возвращает функцию конструктора по умолчанию, которая сама является одним из конструкторов типизированных массивов для любого заданного конструктора типизированного массива.

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

Species в производных объектах

В экземпляре пользовательского подкласса TypedArray, такого как MyTypedArray, species MyTypedArray является конструктором MyTypedArray. Однако вы можете захотеть переопределить это, чтобы возвращать родительский объект типизированного массива в методах вашего производного класса:

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

Спецификации

Совместимость с браузерами

См. также

• TypedArray
• Symbol.species