Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Proxy::Proxy.revocable静的メソッドの使い方

Proxy.revocable()静的メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Proxy.revocable()メソッドは、指定されたオブジェクトへのアクセスを制御し、その制御を後から完全に停止できる「取り消し可能(revocable)」なProxyオブジェクトを作成・提供するメソッドです。

Proxyオブジェクトとは、特定のオブジェクト(ターゲットオブジェクト)に対するプロパティの読み書きやメソッドの呼び出しといった操作を、開発者が定義したルールに基づいて監視したり、その動作を変更したりするための代理人(プロキシ)として機能します。

このProxy.revocable()メソッドの最大の特徴は、作成されたプロキシオブジェクトが「取り消し可能」である点です。これは、一度プロキシオブジェクトを生成した後、特定の条件が満たされた際や、不要になった時点で、そのプロキシの全ての機能を無効化できることを意味します。

具体的には、このメソッドはproxyrevokeという2つのプロパティを持つオブジェクトを返します。proxyプロパティには実際に使用するプロキシオブジェクトが、revokeプロパティにはそのプロキシオブジェクトを無効化するための関数が含まれています。revoke関数を一度呼び出すと、以降そのプロキシオブジェクトに対するいかなる操作もエラーとなり、元のオブジェクトへのアクセスは完全に遮断されます。

これにより、機密性の高いオブジェクトへの一時的なアクセス許可や、使用期限のあるリソースへの参照管理など、セキュリティやリソース管理の側面で非常に有用です。プログラム内で一時的にオブジェクトへの操作を許可し、その後確実にその許可を撤回したい場合に、この機能は大きなメリットをもたらします。一度無効化されたプロキシは元に戻すことはできません。

公式リファレンス: Proxy.revocable()

構文(syntax)

1const { proxy, revoke } = Proxy.revocable(target, handler);

引数(parameters)

target, handler

  • target: 監視対象となるオブジェクト
  • handler: 監視対象オブジェクトへの操作をインターセプト(傍受)し、カスタム動作を定義するオブジェクト

戻り値(return)

{ proxy: Proxy, revoke: Function }

Proxy.revocable() メソッドは、新しい Proxy オブジェクトとその Proxy を無効化(revoke)するための関数を格納したオブジェクトを返します。このオブジェクトは proxy プロパティと revoke プロパティを持ちます。

関連コンテンツ