Reflect.setPrototypeOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die statische Methode Reflect.setPrototypeOf() ist ähnlich wie Object.setPrototypeOf(), gibt jedoch einen Boolean zurück. Sie setzt das Prototype (d.h. die interne [[Prototype]]-Eigenschaft) eines angegebenen Objekts.

Probieren Sie es aus

const object1 = {};

console.log(Reflect.setPrototypeOf(object1, Object.prototype));
// Expected output: true

console.log(Reflect.setPrototypeOf(object1, null));
// Expected output: true

const object2 = {};

console.log(Reflect.setPrototypeOf(Object.freeze(object2), null));
// Expected output: false

Syntax

js
Reflect.setPrototypeOf(target, prototype)

Parameter

target

Das Zielobjekt, dessen Prototype gesetzt werden soll.

prototype

Das neue Prototype des Objekts (ein Objekt oder null).

Rückgabewert

Ein Boolean, der angibt, ob das Prototype erfolgreich gesetzt wurde oder nicht.

Ausnahmen

TypeError

Ausgelöst, wenn target kein Objekt ist oder prototype weder ein Objekt noch null ist.

Beschreibung

Reflect.setPrototypeOf() bietet die reflektive Semantik, um das Prototype eines Objekts zu setzen. Auf sehr niedrigem Niveau gibt das Setzen des Prototypes einen Boolean zurück (wie im Fall des Proxy-Handlers). Object.setPrototypeOf() bietet eine nahezu gleiche Semantik, wirft jedoch einen TypeError, wenn der Status false ist (die Operation war erfolglos), während Reflect.setPrototypeOf() den Status direkt zurückgibt.

Reflect.setPrototypeOf() ruft die [[SetPrototypeOf]] interne Objektsmethode von target auf.

Beispiele

Verwendung von Reflect.setPrototypeOf()

js
Reflect.setPrototypeOf({}, Object.prototype); // true

// It can change an object's [[Prototype]] to null.
Reflect.setPrototypeOf({}, null); // true

// Returns false if target is not extensible.
Reflect.setPrototypeOf(Object.freeze({}), null); // false

// Returns false if it cause a prototype chain cycle.
const target = {};
const proto = Object.create(target);
Reflect.setPrototypeOf(target, proto); // false

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-reflect.setprototypeof

Browser-Kompatibilität

Siehe auch