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

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: Wird ausgelöst, wenn target kein Objekt ist oder wenn prototype weder ein Objekt noch null ist.

Beschreibung

Reflect.setPrototypeOf() bietet die reflektierende Semantik, um das Prototype eines Objekts festzulegen. Auf niedrigster Ebene gibt das Setzen des Prototype einen Boolean zurück (wie es auch bei dem Proxy-Handler der Fall ist). Object.setPrototypeOf() bietet nahezu dieselbe Semantik, löst jedoch einen TypeError aus, wenn der Status false ist (die Operation war nicht erfolgreich), während Reflect.setPrototypeOf() den Status direkt zurückgibt.

Reflect.setPrototypeOf() ruft die Methode [[SetPrototypeOf]] der internen Objektmethoden von target auf.

Beispiele

Verwendung von Reflect.setPrototypeOf()

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