WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.setPrototypeOf — das Prototypobjekt festlegen

Reflect.setPrototypeOf(target, proto) versucht, das Prototypobjekt eines Objekts festzulegen, und gibt einen booleschen Wert zurück. So lässt sich eine abgelehnte Änderung von ungültigen Argumenten unterscheiden, die einen TypeError auslösen.

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

Reflect.setPrototypeOf(target, proto)

Reflect.setPrototypeOf(target, proto) ruft die interne Operation [[SetPrototypeOf]] des Objekts target auf. Das Prototypobjekt dient zum Nachschlagen geerbter Eigenschaften; die Methode kopiert diese nicht in das Objekt. proto muss ein Objekt oder null sein, was bedeutet, dass kein Prototyp vorhanden ist. Dadurch wird nicht die .prototype-Eigenschaft einer Funktion geändert.

Der Wert true bedeutet Erfolg, auch wenn das angegebene Prototypobjekt bereits festgelegt ist. Der Wert false bedeutet, dass die Änderung abgelehnt wurde. Bei einem gewöhnlichen Objekt liefert der Wechsel zu einem anderen Prototyp nach Object.preventExtensions(target) den Wert false. Dasselbe Prototypobjekt erneut festzulegen, bleibt auch bei einem nicht erweiterbaren Objekt erlaubt. Bei der Zyklusprüfung für ein gewöhnliches Objekt gibt die Operation false zurück, wenn sie die Kette ab proto durchläuft und dabei target erreicht. Die Prüfung endet jedoch, sobald sie auf ein Objekt trifft, das nicht die gewöhnliche interne Methode [[GetPrototypeOf]] verwendet. Ein Proxy in der Kette kann daher einen Zyklus ermöglichen, selbst wenn target ein gewöhnliches Objekt ist.

Ein boolescher Rückgabewert schließt Ausnahmen nicht aus: Ein primitiver Wert als target oder ein ungültiges proto führt zu einem TypeError. Fehler der internen Operation, einschließlich Fehlern eines Proxy-Traps, werden weitergegeben. Im Gegensatz dazu gibt Object.setPrototypeOf bei einem Objekt als target im Erfolgsfall das Objekt zurück und löst einen TypeError aus, wenn die interne Operation false zurückgibt.

Das Beispiel zeigt Vererbung ohne Kopieren und den Unterschied zwischen dem Beibehalten und dem Ändern des Prototyps nach dem Verhindern weiterer Erweiterungen. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle; die Verwendung von Node 24 in einem Repository belegt keine Browserunterstützung.

Beispiele

const proto = { label: "shared" };
const item = {};

console.log(Reflect.setPrototypeOf(item, proto));
console.log(item.label);
console.log(Object.hasOwn(item, "label"));

Object.preventExtensions(item);
console.log(Reflect.setPrototypeOf(item, proto));
console.log(Reflect.setPrototypeOf(item, null));
console.log(Object.getPrototypeOf(item) === proto);

Ergebnis

true
shared
false
true
false
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