Proxy.revocable()
The Proxy.revocable() method is used to create a
revocable Proxy object.
Syntax
Proxy.revocable(target, handler);
Parameters
target-
A target object to wrap with
Proxy. It can be any sort of object, including a native array, a function, or even another proxy. handler-
An object whose properties are functions define the behavior of proxy
pwhen an operation is performed on it.
Return value
A newly created revocable Proxy object is returned.
Description
A revocable Proxy is an object with following two properties
{proxy: proxy, revoke: revoke}.
proxy-
A Proxy object created with
new Proxy(target, handler)call. revoke-
A function with no argument to invalidate (switch off) the
proxy.
If the revoke() function gets called, the proxy becomes unusable: Any trap
to a handler will throw a TypeError. Once a proxy is revoked, it will
remain revoked and can be garbage collected. Calling revoke() again has no
effect.
Examples
Using Proxy.revocable
var revocable = Proxy.revocable({}, {
get: function(target, name) {
return "[[" + name + "]]";
}
});
var proxy = revocable.proxy;
console.log(proxy.foo); // "[[foo]]"
revocable.revoke();
console.log(proxy.foo); // TypeError is thrown
proxy.foo = 1 // TypeError again
delete proxy.foo; // still TypeError
typeof proxy // "object", typeof doesn't trigger any trap
Specifications
| Specification |
|---|
| ECMAScript Language Specification # sec-proxy.revocable |
Browser compatibility
BCD tables only load in the browser