WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.setPrototypeOf — das Prototypobjekt ändern

Bei einem gewöhnlichen Objekt setzt ein erfolgreicher Aufruf von `Object.setPrototypeOf(obj, proto)` den internen Prototyp, ohne Eigenschaften zu kopieren, und gibt dasselbe Objekt zurück. `proto` muss ein Objekt oder `null` sein. Bei einem `Proxy` mit erweiterbarem Zielobjekt kann der `setPrototypeOf`-Trap Erfolg melden, ohne den Prototyp des Zielobjekts zu ändern. Der Aufruf gibt dennoch denselben `Proxy` zurück.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Object.setPrototypeOf(obj, proto)

Bei einem gewöhnlichen Objekt setzt ein erfolgreicher Aufruf von Object.setPrototypeOf(obj, proto) das interne [[Prototype]] von obj auf proto. Geerbte Eigenschaften werden über die Prototypkette gesucht und nicht auf das Objekt kopiert. Bei einem gewöhnlichen Objekt wie im Beispiel bleiben dessen eigene Eigenschaften unverändert. Ist obj ein Proxy mit erweiterbarem Zielobjekt, kann dessen setPrototypeOf-Trap Erfolg melden, ohne den Prototyp des Zielobjekts zu ändern. Der Aufruf gibt dennoch denselben Proxy zurück. Der Trap kann bei einem erfolgreichen Aufruf auch die eigenen Eigenschaften des Zielobjekts ändern. Ein Aufruf von Object.setPrototypeOf ist keine Zuweisung an die .prototype-Eigenschaft einer Funktion.

proto muss ein Objekt oder null sein; jeder andere Wert verursacht einen TypeError. Auch null oder undefined als obj verursachen einen TypeError. Andere primitive Werte werden unverändert zurückgegeben, allerdings erst, nachdem proto geprüft wurde. Bei einem Objekt gibt ein erfolgreicher Aufruf genau obj zurück.

Wird beim Ändern des Prototyps eines gewöhnlichen Objekts ein Zyklus erkannt, kommt es zu einem TypeError. Die Prüfung endet jedoch bei einem Prototyp, der nicht die gewöhnliche Implementierung der internen Methode [[GetPrototypeOf]] verwendet, etwa bei einem Proxy. Ein Zyklus über diesen Proxy kann daher unentdeckt bleiben, ohne einen TypeError auszulösen. Der Versuch, den Prototyp eines nicht erweiterbaren gewöhnlichen Objekts zu ändern, verursacht einen TypeError. Bei einem gewöhnlichen Objekt darf der bisherige Prototyp auch dann erneut gesetzt werden, wenn das Objekt nicht erweiterbar ist. Bei einem Proxy mit nicht erweiterbarem Zielobjekt kann der setPrototypeOf-Trap die Operation dagegen auch dann ablehnen, wenn der angeforderte Prototyp dem aktuellen Prototyp des Zielobjekts entspricht. Gibt der Trap false zurück, löst Object.setPrototypeOf einen TypeError aus. Einige Objekte, darunter Object.prototype, haben einen unveränderlichen Prototyp.

Wird der Prototyp eines Objekts auf null geändert, wird die bisherige Vererbungskette unterbrochen; das Objekt kann dadurch den Zugriff auf geerbte Methoden verlieren. Ist der Prototyp beim Erstellen des Objekts bekannt, kommt statt einer späteren Änderung Object.create(proto) infrage. Im Beispiel wird role geerbt, während name eine eigene Eigenschaft bleibt.

Beispiele

const proto = { role: "reader" };
const user = { name: "Ada" };
const result = Object.setPrototypeOf(user, proto);

console.log(result === user);
console.log(Object.getPrototypeOf(user) === proto);
console.log(user.role);
console.log(Object.getOwnPropertyNames(user).join(","));

Object.setPrototypeOf(user, null);
console.log(user.role === undefined);

Ergebnis

true
true
reader
name
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen