handler.get()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
handler.get()
は、オブジェクトの [[Get]]
内部メソッドに対するトラップです。プロパティアクセサーなどの操作で使用されます。
試してみましょう
構文
js
new Proxy(target, {
get(target, property, receiver) {
}
});
引数
返値
get()
メソッドはどんな値でも返すことができます。
解説
介入
このトラップは下記の操作に介入できます。
- プロパティアクセス:
proxy[foo]
とproxy.bar
Reflect.get()
他にも、[[Get]]
内部メソッドを呼び出すあらゆる操作に介入できます。
不変条件
以下の不変条件に違反している場合、プロキシーは TypeError
を発生します。
- ターゲットオブジェクトプロパティが書き込み不可、構成不可の自分自身のデータプロパティである場合、プロパティとして報告される値は、対応するターゲットオブジェクトプロパティの値と同じでなければなりません。
- 対応する対象オブジェクトのプロパティが、
[[Get]]
属性としてundefined
を持つ、構成不可の自分自身のアクセサープロパティである場合、プロパティに対して報告される値は undefined でなければなりません。
例
プロパティ値の取得のトラップ
次のコードではプロパティ値の取得をトラップします。
js
const p = new Proxy(
{},
{
get(target, property, receiver) {
console.log(`called: ${property}`);
return 10;
},
},
);
console.log(p.a);
// "called: a"
// 10
次のコードでは不変条件に違反します。
js
const obj = {};
Object.defineProperty(obj, "a", {
configurable: false,
enumerable: false,
value: 10,
writable: false,
});
const p = new Proxy(obj, {
get(target, property) {
return 20;
},
});
p.a; // TypeError is thrown
仕様書
Specification |
---|
ECMAScript Language Specification # sec-proxy-object-internal-methods-and-internal-slots-get-p-receiver |
ブラウザーの互換性
BCD tables only load in the browser