handler.get()

const p = new Proxy(target, {
  get: function(target, property, receiver) {
  }
});

次の引数が get() メソッドに渡されます。 this はハンドラーにバインドされます。

target

ターゲットオブジェクト

property

取得するプロパティの名称

receiver

proxy、または proxy から継承するオブジェクトのどちらか

get() メソッドはどんな値でも返すことができます。

handler.get() メソッドはプロパティ値を取得することに対するトラップです。

このトラップは下記の操作に介入できます。

• プロパティアクセス: proxy[foo] と proxy.bar
• 継承したプロパティアクセス: Object.create(proxy)[foo]
• Reflect.get()

以下の不変条件に違反している場合、プロキシは TypeError を発生します。

• ターゲットオブジェクトプロパティが書き込み不可で非設定なデータプロパティなら、プロパティに対して報告される値は対応するターゲットオブジェクトプロパティと同じでなければなりません。
• 対応するターゲットオブジェクトプロパティが[[Get]]属性として未定義で非設定なアクセスプロパティなら、プロパティに対して報告される値は未定義でなければなりません。

次のコードではプロパティ値の取得をトラップします。

const p = new Proxy({}, {
  get: function(target, property, receiver) {
    console.log('called: ' + property);
    return 10;
  }
});

console.log(p.a); // "called: a"
                  // 10

次のコードでは不変条件に違反します。

const obj = {};
Object.defineProperty(obj, 'a', {
  configurable: false,
  enumerable: false,
  value: 10,
  writable: false
});

const p = new Proxy(obj, {
  get: function(target, property) {
    return 20;
  }
});

p.a; // TypeError is thrown

• Proxy
• handler
• Reflect.get()