From 0a8266a4887cf47252943843204a9a11aabf2593 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 14 Sep 2021 11:10:52 +0900 Subject: Global_Objects/Proxy/revocable を更新 (#2343) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdownに変換 - 2021/07/21 時点の英語版に同期 --- .../global_objects/proxy/revocable/index.html | 89 ---------------------- .../global_objects/proxy/revocable/index.md | 75 ++++++++++++++++++ 2 files changed, 75 insertions(+), 89 deletions(-) delete mode 100644 files/ja/web/javascript/reference/global_objects/proxy/revocable/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/proxy/revocable/index.md (limited to 'files/ja/web/javascript/reference') diff --git a/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.html b/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.html deleted file mode 100644 index b1f9e54ea8..0000000000 --- a/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Proxy.revocable() -slug: Web/JavaScript/Reference/Global_Objects/Proxy/revocable -tags: - - ECMAScript 2015 - - JavaScript - - Method - - Proxy -translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/revocable ---- -
{{JSRef}}
- -

Proxy.revocable() メソッドは、取り消し可能な {{jsxref("Proxy")}} オブジェクトを作成できます。

- -

構文

- -
Proxy.revocable(target, handler);
-
- -

引数

- -
-
-
target
-
Proxy でラップする対象のオブジェクトです。これは一連のオブジェクト、例えばネイティブの配列、関数、他の. Proxy などを取ることもできます。
-
handler
-
オブジェクトで、プロパティが操作が実行されたときのプロキシ p の動作を定義する関数であるものです。
-
-
- -

返値

- -

新しく作成された取り消し可能な Proxy オブジェクト。

- -

解説

- -

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

- -
-
proxy
-
new Proxy(target, handler) 呼び出しで生成したプロキシオブジェクトです。
-
revoke
-
proxy を無効にするための引数を持たない関数です。
-
- -

revoke() 関数を呼ぶと、プロキシオブジェクトは使用できなくなり、ハンドラーへのどんなトラップも {{jsxref("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
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-proxy.revocable', 'Proxy Revocation Functions')}}
- -

ブラウザーの互換性

- -

{{Compat("javascript.builtins.Proxy.revocable")}}

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.md b/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.md new file mode 100644 index 0000000000..25045bea38 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/proxy/revocable/index.md @@ -0,0 +1,75 @@ +--- +title: Proxy.revocable() +slug: Web/JavaScript/Reference/Global_Objects/Proxy/revocable +tags: + - ECMAScript 2015 + - JavaScript + - Method + - Proxy +browser-compat: javascript.builtins.Proxy.revocable +translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/revocable +--- +{{JSRef}} + +**`Proxy.revocable()`** メソッドは、取り消し可能な {{jsxref("Proxy")}} オブジェクトを作成するために使用します。 + +## 構文 + +```js +Proxy.revocable(target, handler); +``` + +### 引数 + +- `target` + - : `Proxy` でラップする対象のオブジェクトです。これは一連のオブジェクト、例えばネイティブの配列、関数、他のプロキシーなどを取ることもできます。 +- `handler` + - : プロキシー `p` に対して操作が行われたときの動作を定義する関数をプロパティとするオブジェクトです。 + +### 返値 + +新しく作成された取り消し可能な `Proxy` オブジェクト。 + +## 解説 + +取り消し可能な `Proxy` は `{proxy: proxy, revoke: revoke}` の 2 つのプロパティを持ったオブジェクトです。 + +- `proxy` + - : `new Proxy(target, handler)` 呼び出しで生成したプロキシーオブジェクトです。 +- `revoke` + - : `proxy` を無効にするための引数を持たない関数です。 + +`revoke()` 関数を呼び出すと、プロキシーオブジェクトは使用できなくなります。ハンドラーへのトラップが発生すると、どれでも {{jsxref("TypeError")}} が発生します。プロキシーが取り消されると、取り消されたままになり、ガベージコレクションの対象となります。再度 `revoke()` が呼ばれても影響はありません。 + +## 例 + +### Proxy.revocable の使用 + +```js +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 が発生 +proxy.foo = 1 // TypeError が発生 +delete proxy.foo; // これも TypeError +typeof proxy // "object" と表示。 typeof でトラップは発生しない +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{jsxref("Proxy")}} -- cgit v1.2.3-54-g00ecf