Object.setPrototypeOf()

obj

プロトタイプを設定するオブジェクト。

prototype

オブジェクトの新しいプロトタイプ（オブジェクトまたは null）。

指定されたオブジェクト。

TypeError

以下のいずれかの場合に発生します。

• 引数 obj が undefined または null である場合。
• 引数 obj が拡張不可能であるか、またはプロトタイプが不変のエキゾチックオブジェクト、例えば Object.prototype や window 等の場合。ただし、新しいプロトタイプが obj の元のプロトタイプと同じ値である場合は、エラーは発生しません。
• 引数 prototype がオブジェクトまたは null ではない場合。

Object.setPrototypeOf() は、一般的にオブジェクトのプロトタイプを設定するための適切な方法と考えられています。非推奨の Object.prototype.__proto__ アクセサーの代わりに、常にこれを使用するべきでしょう。

もし引数 obj がオブジェクト（例えば、数値、文字列など）でない場合、このメソッドは何もせず、オブジェクトに変換したり、プロトタイプを設定することなく、直接 obj をプリミティブ値として返します。もし prototype が obj のプロトタイプと同じ値であれば、 obj のプロトタイプが不変であっても TypeError は発生せずに obj が直接返されます。

セキュリティの観点から、プロトタイプが不変であるように設計された組み込みオブジェクトがあります。これにより、プロトタイプ汚染攻撃、特にブロキシー関連の攻撃を防ぐことができます。コア言語では、不変のプロトタイプを持つエキゾチックオブジェクトとして Object.prototype のみを指定しており、そのプロトタイプは常に null です。ブラウザーでは、 window や location の 2 つがとても一般的な例です。

Object.isExtensible(Object.prototype); // true。プロパティを追加できる
Object.setPrototypeOf(Object.prototype, {}); // TypeError: 不変のプロトタイプオブジェクト '#<Object>' にプロトタイプを設定することはできない
Object.setPrototypeOf(Object.prototype, null); // エラーなし。 `Object.prototype` のプロパティがすでに `null` であるため

クラスを使用した JS の継承です。

class Human {}
class SuperHero extends Human {}

const superMan = new SuperHero();

しかし、 class を使わずにサブクラスを実装したい場合は、次のようにします。

function Human(name, level) {
  this.name = name;
  this.level = level;
}

function SuperHero(name, level) {
  Human.call(this, name, level);
}

Object.setPrototypeOf(SuperHero.prototype, Human.prototype);

// `SuperHero.prototype` の `[[Prototype]]` を `Human.prototype` に設定
// プロトタイプのインスタンスチェーンを設定するため

Human.prototype.speak = function () {
  return `${this.name} says hello.`;
};

SuperHero.prototype.fly = function () {
  return `${this.name} is flying.`;
};

const superMan = new SuperHero("Clark Kent", 1);

console.log(superMan.fly());
console.log(superMan.speak());

上記のような古典的継承（クラスによる継承）と擬似古典的継承（コンストラクターの prototype プロパティによる継承）の類似性については、継承チェーンで述べられています。

関数コンストラクターの prototype プロパティは書き込み可能なので、 Object.create() で作成した新しいオブジェクトに再割り当てすることで、同じ継承連鎖を実現できます。 create() を使用する際には、 constructor プロパティを再度追加することを忘れないようにするなどの注意点があります。

以下の例でもクラスを使用していますが、 SuperHero は extends を使用せずに、代わりに setPrototypeOf() を使用して Human を継承しています。

class Human {}
class SuperHero {}

// 継承プロパティを設定
Object.setPrototypeOf(SuperHero.prototype, Human.prototype);

// 静的プロパティをフック
Object.setPrototypeOf(SuperHero, Human);

const superMan = new SuperHero();

extends を使わないサブクラス化は、 ES-6 subclassing で触れられています。

• Object.setPrototypeOf のポリフィル (core-js)
• Reflect.setPrototypeOf()
• Object.prototype.isPrototypeOf()
• Object.getPrototypeOf()
• Object.prototype.__proto__
• 継承チェーン
• ES6 In Depth: Subclassing on hacks.mozilla.org (2015)