Object.setPrototypeOf()

Статический метод Object.setPrototypeOf() устанавливает прототип (то есть внутреннее свойство [[Prototype]]) указанного объекта другим объектом или null.

Попробуйте

const obj = {};
const parent = { foo: "bar" };

console.log(obj.foo);
// Expected output: undefined

Object.setPrototypeOf(obj, parent);

console.log(obj.foo);
// Expected output: "bar"

Синтаксис

Object.setPrototypeOf(obj, prototype)

Параметры

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 являются двумя другими очень распространенными примерами.

Object.isExtensible(Object.prototype); // true; you can add more properties
Object.setPrototypeOf(Object.prototype, {}); // TypeError: Immutable prototype object '#<Object>' cannot have their prototype set
Object.setPrototypeOf(Object.prototype, null); // No error; the prototype of `Object.prototype` is already `null`

Примеры

Псевдоклассовое наследование с использованием Object.setPrototypeOf()

Наследование в 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);

// Set the `[[Prototype]]` of `SuperHero.prototype`
// to `Human.prototype`
// To set the prototypal inheritance chain

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 наследуется от Human без использования extends, вместо этого используя setPrototypeOf().

class Human {}
class SuperHero {}

// Set the instance properties
Object.setPrototypeOf(SuperHero.prototype, Human.prototype);

// Hook up the static properties
Object.setPrototypeOf(SuperHero, Human);

const superMan = new SuperHero();

Подклассы без extends упоминаются в ES-6 subclassing.

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

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

См. также

• Polyfill of Object.setPrototypeOf in core-js
• Reflect.setPrototypeOf()
• Object.prototype.isPrototypeOf()
• Object.getPrototypeOf()
• Object.prototype.__proto__
• Цепочка наследования
• ES6 In Depth: Subclassing on hacks.mozilla.org (2015)