Object.setPrototypeOf()

obj

Das Objekt, dessen Prototyp gesetzt werden soll.

prototype

Der neue Prototyp des Objekts (ein Objekt oder null).

Das angegebene Objekt.

TypeError

Wird in einem der folgenden Fälle ausgelöst:

• Der obj-Parameter ist undefined oder null.
• Der obj-Parameter ist nicht erweiterbar oder es handelt sich um ein unveränderliches Prototyp-exotisches Objekt, wie Object.prototype oder window. Der Fehler wird jedoch nicht ausgelöst, wenn der neue Prototyp denselben Wert wie der ursprüngliche Prototyp von obj hat.
• Der prototype-Parameter ist kein Objekt oder null.

Object.setPrototypeOf() gilt allgemein als der richtige Weg, um den Prototyp eines Objekts festzulegen. Sie sollten es immer dem veralteten Object.prototype.__proto__-Zugriff vorziehen.

Wenn der obj-Parameter kein Objekt ist (z.B. Zahl, Zeichenkette, etc.), tut diese Methode nichts — ohne es zu einem Objekt zu erzwingen oder zu versuchen, seinen Prototyp zu setzen — und gibt obj direkt als primitiven Wert zurück. Wenn prototype denselbe Wert wie der Prototyp von obj ist, wird obj direkt zurückgegeben, ohne dass ein TypeError auftritt, selbst wenn obj einen unveränderlichen Prototyp hat.

Aus Sicherheitsgründen gibt es bestimmte eingebaute Objekte, die so konzipiert sind, dass sie ein unveränderliches Prototyp haben. Dies verhindert Angriffe durch Prototypenverschmutzung, insbesondere proxy-bezogene Angriffe. Die Kernsprache spezifiziert nur Object.prototype als unveränderliches Prototyp-exotisches Objekt, dessen Prototyp immer null ist. In Browsern sind window und location zwei weitere sehr häufige Beispiele.

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`

Vererbung in JS unter Verwendung von Klassen.

class Human {}
class SuperHero extends Human {}

const superMan = new SuperHero();

Wenn wir jedoch Unterklassen implementieren möchten, ohne class zu verwenden, können wir Folgendes tun:

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());

Die Ähnlichkeit zwischen klassischer Vererbung (mit Klassen) und pseudoklassischer Vererbung (mit prototype-Eigenschaft von Konstruktoren), wie oben gezeigt, wird in Vererbungsketten erwähnt.

Da die prototype-Eigenschaft von Funktionskonstruktoren beschreibbar ist, können Sie es einem neuen Objekt, das mit Object.create() erstellt wurde, zuweisen, um die gleiche Vererbungskette zu erstellen. Es gibt jedoch Vorbehalte bei der Verwendung von create(), wie etwa daran zu denken, die constructor-Eigenschaft wieder hinzuzufügen.

Im folgenden Beispiel, das ebenfalls Klassen verwendet, wird SuperHero so gestaltet, dass es von Human erbt, ohne extends zu verwenden, indem stattdessen setPrototypeOf() verwendet wird.

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();

Das Unterklassen ohne extends wird in ES-6 subclassing erwähnt.

• Polyfill von Object.setPrototypeOf in core-js
• Reflect.setPrototypeOf()
• Object.prototype.isPrototypeOf()
• Object.getPrototypeOf()
• Object.prototype.__proto__
• Vererbungskette
• ES6 In Depth: Subclassing auf hacks.mozilla.org (2015)