Object.setPrototypeOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die statische Methode Object.setPrototypeOf()
setzt das Prototyp-Objekt (d.h. die interne Eigenschaft [[Prototype]]
) 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 Zugriffe auf Eigenschaften optimieren, derzeit eine sehr langsame Operation in jedem Browser und jeder 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 im Object.setPrototypeOf(...)
-Statement verbracht wird, sondern können sich auf jedes Code stück ausdehnen, das auf ein Objekt zugreifen kann, dessen [[Prototype]]
geändert wurde. Mehr dazu können Sie in JavaScript engine fundamentals: optimizing prototypes lesen.
Weil diese Funktion ein Teil der Sprache ist, liegt es immer noch in der Verantwortung der Engine-Entwickler, diese Funktion performant zu implementieren (idealerweise). Bis die Engine-Entwickler dieses Problem angehen, sollten Sie, wenn Sie sich um die Leistung sorgen, vermeiden, das [[Prototype]]
eines Objekts zu setzen. Stattdessen sollten Sie ein neues Objekt mit dem gewünschten [[Prototype]]
mit Object.create()
erstellen.
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
Rückgabewert
Das angegebene Objekt.
Ausnahmen
TypeError
-
Wird in einem der folgenden Fälle ausgelöst:
- Der
obj
-Parameter istundefined
odernull
. - Der
obj
-Parameter ist nicht erweiterbar oder er ist ein unveränderliches Prototyp-Objekt, wieObject.prototype
oderwindow
. Ein Fehler wird jedoch nicht ausgelöst, wenn das neue Prototyp-Objekt denselben Wert hat wie das ursprüngliche Prototyp-Objekt vonobj
. - Der
prototype
-Parameter ist kein Objekt odernull
.
- Der
Beschreibung
Object.setPrototypeOf()
wird allgemein als die richtige Methode angesehen, um das Prototyp eines Objekts zu setzen. Sie sollten es immer dem veralteten Object.prototype.__proto__
-Accessor vorziehen.
Wenn der obj
-Parameter kein Objekt ist (z.B. Zahl, String, etc.), macht diese Methode nichts — ohne es zu einem Objekt zu erzwingen oder zu versuchen, sein Prototyp zu setzen — und gibt obj
direkt als primitiven Wert zurück. Wenn prototype
denselben Wert wie der Prototyp von obj
hat, wird obj
direkt zurückgegeben, ohne einen TypeError
zu verursachen, selbst wenn obj
ein unveränderliches Prototyp hat.
Aufgrund von Sicherheitsbedenken gibt es bestimmte eingebaut Objekte, die so gestaltet sind, dass sie ein unveränderliches Prototyp haben. Dies verhindert Angriffe zur Prototyp-Verunreinigung, insbesondere bei Proxy-bezogenen. Die Hauptsprache spezifiziert nur Object.prototype
als ein unveränderliches Prototyp-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`
Beispiele
Pseudoklassische 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 die Verwendung von class
implementieren möchten, 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 dem prototype
-Property der Konstruktoren), wie oben beschrieben, wird in Inheritance chains erwähnt.
Da das prototype
-Property von Funktionskonstruktoren beschreibbar ist, können Sie es einem neuen Objekt, das mit Object.create()
erstellt wurde, neu zuweisen, um die gleiche Vererbungskette zu erreichen. Es gibt jedoch einige Dinge, auf die beim Verwenden von create()
geachtet werden muss, wie etwa das erneute Hinzufügen der constructor
-Eigenschaft.
Im folgenden Beispiel, in dem auch Klassen verwendet werden, wird SuperHero
so erstellt, dass es von Human
erbt, ohne extends
zu verwenden, indem statt dessen setPrototypeOf()
verwendet wird.
Warnung:
Es ist nicht ratsam, setPrototypeOf()
anstelle von extends
zu verwenden, aufgrund von Performance- und Lesbarkeitsgründen.
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 Subclassing ohne extends
wird in ES-6 subclassing erwähnt.
Spezifikationen
Specification |
---|
ECMAScript® 2026 Language Specification # sec-object.setprototypeof |