Promise[Symbol.species]

get [Symbol.species] が呼び出されたコンストラクター (this) の値です。この返値は、新しいプロミスを作成するプロミス連鎖メソッドから返値を作成するために使用されます。

[Symbol.species] アクセサープロパティは Promise オブジェクトの既定のコンストラクターを返します。サブクラスのコンストラクターはこれを上書きしてコンストラクターの割り当てを変更することができます。既定の実装では、基本的に次のようになります。

// 解説のため架空の基礎実装
class Promise {
  static get [Symbol.species]() {
    return this;
  }
}

この多相的な実装のため、派生したサブクラスの [Symbol.species] も既定ではコンストラクター自身を返すことになります。

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

プロミス連鎖メソッドである then()、catch()、finally() は、新しいプロミスオブジェクトを返します。これらは this.constructor[Symbol.species] を介して新しいプロミスを構築するためのコンストラクターを取得します。 this.constructor が undefined の場合、または this.constructor[Symbol.species] が undefined または null の場合、既定の Promise() コンストラクターが使用されます。それ以外の場合は、 this.constructor[Symbol.species] から返されるコンストラクターが使用され、新しいプロミスオブジェクトが構築されます。

Symbol.species プロパティは、既定では Promise のコンストラクター関数を返します。

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

MyPromise のような独自の Promise サブクラスのインスタンスでは、 MyPromise コンストラクターが MyPromise の species となります。しかし、派生クラスのメソッドで親の Promise オブジェクトを返すために、これをオーバーライドしたい場合があるかもしれません。

class MyPromise extends Promise {
  // MyPromise の species を親の Promise コンストラクターで上書きする
  static get [Symbol.species]() {
    return Promise;
  }
}

既定では、プロミスメソッドはサブクラスの型を持つプロミスを返します。

class MyPromise extends Promise {
  someValue = 1;
}

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

[Symbol.species] を上書きすることで、プロミスのメソッドは基底の Promise 型を返すことになります。

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

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

• Promise
• Symbol.species