Proxy.revocable()

基线广泛可用

自 2017年12月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

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

本文内容

语法

Proxy.revocable(target, handler); target

将用 Proxy 封装的目标对象。可以是任何类型的对象，包括原生数组，函数，甚至可以是另外一个代理对象。

handler

一个对象，其属性是一批可选的函数，这些函数定义了对应的操作被执行时代理的行为。

描述

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

proxy

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

revoke

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

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

示例

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

revocable.revoke();

console.log(proxy.foo); // 抛出 TypeError
proxy.foo = 1; // 还是 TypeError
delete proxy.foo; // 又是 TypeError
typeof proxy; // "object"，因为 typeof 不属于可代理操作

Proxy

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题

Proxy.revocable()

本文内容

语法

返回值

描述

示例

规范

浏览器兼容性

参见

帮助改进 MDN