Proxy.revocable()

概要

取消可能なProxy オブジェクトを生成します。

構文

Proxy.revocable(target, handler);

target

A target object (can be any sort of objects, including a native array, a function or even another proxy) or function to wrap with Proxy.

handler

An object whose properties are functions which define the behavior of the proxy when an operation is performed on it.

戻り値

新しい生成した取消可能なProxy オブジェクトが返されます。

説明

取消可能なProxyは次の２つのプロパティ{proxy: proxy, revoke: revoke}を持ったオブジェクトです。

proxy

new Proxy(target, handler)呼び出しで生成したプロキシオブジェクト

revoke

proxyを無効にするための引数を持たない関数

revoke() 関数が呼ばれたら、プロキシは使用できなくなります。: ハンドラへのどんなトラップもTypeErrorをスローします。プロキシが取り消されると、取り消されたままになり、ガベージコレクションの対象となります。再度revoke() が呼ばれても影響はありません。

例

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

仕様

ブラウザ実装状況

関連情報

• Proxy