Promise[Symbol.species]

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

Синтаксис

Promise[Symbol.species]

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

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

Описание

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

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

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

class SubPromise extends Promise {}
SubPromise[Symbol.species] === SubPromise; // true

Методы цепочки Promise — then(), catch() и finally() — возвращают новые объекты Promise. Они получают конструктор для создания нового Promise через this.constructor[Symbol.species]. Если this.constructor равен undefined, или если this.constructor[Symbol.species] равен undefined или null, используется конструктор по умолчанию Promise(). В противном случае для создания нового объекта Promise используется конструктор, возвращаемый this.constructor[Symbol.species].

Примеры

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

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

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

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

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

class MyPromise extends Promise {
  // Override MyPromise species to the parent Promise constructor
  static get [Symbol.species]() {
    return Promise;
  }
}

По умолчанию методы Promise будут возвращать Promise типа подкласса.

class MyPromise extends Promise {
  someValue = 1;
}

console.log(MyPromise.resolve(1).then(() => {}).someValue); // 1

Переопределяя [Symbol.species], методы Promise будут возвращать базовый тип Promise.

class MyPromise extends Promise {
  someValue = 1;
  static get [Symbol.species]() {
    return Promise;
  }
}

console.log(MyPromise.resolve(1).then(() => {}).someValue); // undefined

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

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

См. также

• Promise
• Symbol.species