Object.setPrototypeOf()

Probieren Sie es aus

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

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

Object.setPrototypeOf(obj, parent);

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

Syntax

Object.setPrototypeOf(obj, prototype)

Parameter

obj

Das Objekt, dessen Prototyp gesetzt werden soll.

prototype

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

Rückgabewert

Das angegebene Objekt.

Ausnahmen

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. Die Fehlermeldung wird jedoch nicht ausgelöst, wenn der neue Prototyp denselben Wert hat wie der ursprüngliche Prototyp von obj.
• Der prototype-Parameter ist kein Objekt oder null.

Beschreibung

Object.setPrototypeOf() wird allgemein als der richtige Weg angesehen, den Prototyp eines Objekts zu setzen. Sie sollten es immer zugunsten des veralteten Object.prototype.__proto__-Zugriffs verwenden.

Wenn der obj-Parameter kein Objekt ist (z.B. Zahl, Zeichenkette, etc.), führt diese Methode keine Aktion durch — ohne es in ein Objekt umzuwandeln oder zu versuchen, dessen Prototyp zu setzen — und gibt obj direkt als primitiven Wert zurück. Wenn prototype denselben Wert hat wie der Prototyp von obj, dann wird obj direkt zurückgegeben, ohne dass ein TypeError verursacht wird, selbst wenn obj ein unveränderlicher Prototyp ist.

Aus Sicherheitsgründen gibt es bestimmte integrierte Objekte, die so konzipiert sind, dass sie einen unveränderlichen Prototyp haben. Dies verhindert Prototype-Pollution-Angriffe, insbesondere [proxy-bezogene] (https://github.com/tc39/ecma262/issues/272). Die Kernsprache gibt nur Object.prototype als ein unveränderliches Prototyp-exotisches Objekt an, 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`

Beispiele

Pseudo-klassische Vererbung mit Object.setPrototypeOf()

Vererbung in JS unter Verwendung von Klassen.

class Human {}
class SuperHero extends Human {}

const superMan = new SuperHero();

Wenn wir jedoch Unterklassen ohne Verwendung von class implementieren wollen, 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 pseudo-klassischer Vererbung (mit prototype-Eigenschaft von Konstruktoren), wie oben dargestellt, wird in Vererbungsketten erwähnt.

Da die prototype-Eigenschaft von Funktionskonstruktoren schreibbar ist, können Sie sie einer neuen mit Object.create() erstellten Objekt zuweisen, um dieselbe Vererbungskette zu erreichen. Es gibt jedoch Vorbehalte zu beachten, wenn Sie create() verwenden, wie z. B. das Erinnern daran, die constructor-Eigenschaft erneut 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();

Die Unterklassenbildung ohne extends wird im Abschnitt ES-6-Unterklassenbildung erwähnt.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• 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)