This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Symbol.species

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨сентябрь 2016 г.⁩.

Symbol.species известный символ, позволяющий определить конструктор, использующийся для создания порождённых объектов.

Атрибуты свойства Symbol.species
Записываемоенет
Перечисляемоенет
Настраиваемоенет

Описание

Свойство Symbol.species, содержащее аксессор (геттер), позволяет подклассам переопределить конструктор, используемый по умолчанию для создания новых объектов.

Примеры

Вам может понадобиться возвращать объекты типа Array в методах вашего производного класса MyArray. Например, при использовании метода вроде map(), использующего конструктор по умолчанию, вам может потребоваться возвращать объект родительского типа Array, вместо MyArray. Символ species позволит вам это сделать:

js
class MyArray extends Array {
  // Перегружаем species для использования родительского конструктора Array
  static get [Symbol.species]() {
    return Array;
  }
}
var a = new MyArray(1, 2, 3);
var mapped = a.map((x) => x * x);

console.log(mapped instanceof MyArray); // false
console.log(mapped instanceof Array); // true

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

Specification
ECMAScript® 2026 Language Specification
# sec-symbol.species

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

Смотрите также