Proxy.revocable()

概述

Proxy.revocable() 方法可以用来创建一个可撤销的代理对象。

语法

Proxy.revocable(target, handler);

target

目标对象，可以是任意类型的对象，比如数组，函数，甚至是另外一个代理对象。

handler

处理器对象，包含了一组代理方法，分别控制所生成代理对象的各种行为。

返回值

返回一个包含了所生成的代理对象本身以及该代理对象的撤销方法的对象。

描述

该方法的返回值是一个对象，其结构为： {"proxy": proxy, "revoke": revoke}，其中：

proxy

表示新生成的代理对象本身，和用一般方式 new Proxy(target, handler) 创建的代理对象没什么不同，只是它可以被撤销掉。

revoke

撤销方法，调用的时候不需要加任何参数，就可以撤销掉和它一起生成的那个代理对象。

一旦某个代理对象被撤销，它将变的几乎完全不可用，在它身上执行任何的可代理操作都会抛出 TypeError 异常（注意，可代理操作一共有 14 种，执行这 14 种操作以外的操作不会抛出异常）。一旦被撤销，这个代理对象永远不可能恢复到原来的状态，同时和它关联的目标对象以及处理器对象将有可能被垃圾回收掉。调用撤销方法多次将不会有任何效果，当然，也不会报错。

示例

var revocable = Proxy.revocable({}, {
  get(target, name) {
    return "[[" + name + "]]";
  }
});
var proxy = revocable.proxy;
proxy.foo;              // "[[foo]]"

revocable.revoke();     // 执行撤销方法

proxy.foo;              // TypeError
proxy.foo = 1           // 同样 TypeError
delete proxy.foo;       // 还是 TypeError
typeof proxy            // "object"，因为 typeof 不属于可代理操作

规范

浏览器兼容性

相关链接

• Proxy