The handler.setPrototypeOf()
method is a trap for the [[SetPrototypeOf]]
object internal method, which is used by operations such as Object.setPrototypeOf()
.
The handler.setPrototypeOf()
method is a trap for the [[SetPrototypeOf]]
object internal method, which is used by operations such as Object.setPrototypeOf()
.
new Proxy(target, { setPrototypeOf(target, prototype) { } });
The setPrototypeOf()
method returns true
if the [[Prototype]]
was successfully changed, otherwise false
.
This trap can intercept these operations:
Or any other operation that invokes the [[SetPrototypeOf]]
internal method.
If the following invariants are violated, the trap throws a TypeError
when invoked.
target
is not extensible, the prototype
parameter must be the same value as Object.getPrototypeOf(target)
. If you want to disallow setting a new prototype for your object, your handler's setPrototypeOf()
method can either return false
, or it can throw an exception.
This approach means that any mutating operation that throws an exception on failure to mutate, must create the exception itself.
For example, Object.setPrototypeOf()
will create and throw a TypeError
itself. If the mutation is performed by an operation that doesn't ordinarily throw in case of failure, such as Reflect.setPrototypeOf()
, no exception will be thrown.
const handlerReturnsFalse = { setPrototypeOf(target, newProto) { return false; }, }; const newProto = {}, target = {}; const p1 = new Proxy(target, handlerReturnsFalse); Object.setPrototypeOf(p1, newProto); // throws a TypeError Reflect.setPrototypeOf(p1, newProto); // returns false
The latter approach will cause any operation that attempts to mutate, to throw. This approach is best if you want even non-throwing operations to throw on failure, or you want to throw a custom exception value.
const handlerThrows = { setPrototypeOf(target, newProto) { throw new Error("custom error"); }, }; const newProto = {}, target = {}; const p2 = new Proxy(target, handlerThrows); Object.setPrototypeOf(p2, newProto); // throws new Error("custom error") Reflect.setPrototypeOf(p2, newProto); // throws new Error("custom error")
Specification |
---|
ECMAScript Language Specification # sec-proxy-object-internal-methods-and-internal-slots-setprototypeof-v |
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
setPrototypeOf |
49 | 12 | 49 | 36 | 10 | 49 | 49 | 36 | 10 | 5.0 | 49 | 1.0 | 6.0.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/setPrototypeOf