Object.setPrototypeOf() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Object.setPrototypeOf()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2015 browserübergreifend verfügbar.

Die Object.setPrototypeOf() statische Methode setzt das Prototyp (d.h. die interne [[Prototype]]-Eigenschaft) eines angegebenen Objekts auf ein anderes Objekt oder null.

Warnung: Das Ändern des [[Prototype]] eines Objekts ist aufgrund der Art und Weise, wie moderne JavaScript-Engines Eigenschaftszugriffe optimieren, derzeit eine sehr langsame Operation in jedem Browser und JavaScript-Engine. Darüber hinaus sind die Auswirkungen der Änderung der Vererbung subtil und weitreichend und beschränken sich nicht nur auf die Zeit, die in der Object.setPrototypeOf(...)-Anweisung verbracht wird, sondern können sich auf jeden Code erstrecken, der auf ein Objekt zugreift, dessen [[Prototype]] verändert wurde. Mehr dazu können Sie unter JavaScript-Engine-Grundlagen: Optimierung von Prototypen lesen.

Da dieses Feature Teil der Sprache ist, liegt es weiterhin in der Verantwortlichkeit der Engine-Entwickler, dieses Feature performant zu implementieren (idealerweise). Bis die Engine-Entwickler dieses Problem lösen, sollten Sie, wenn Ihnen die Leistung wichtig ist, es vermeiden, das [[Prototype]] eines Objekts zu setzen. Stattdessen sollten Sie ein neues Objekt mit dem gewünschten [[Prototype]] unter Verwendung von Object.create() erstellen.

In diesem Artikel

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.

js
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.

js
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:

js
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.

Warnung: Es ist nicht ratsam, setPrototypeOf() anstelle von extends zu verwenden, aus Leistungs- und Lesbarkeitsgründen.

js
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.

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)

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Object
Konstruktor
1. Object()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor