handler.defineProperty()

概要

Object.defineProperty()に対するトラップです。

構文

var p = new Proxy(target, {
  defineProperty: function(target, property, descriptor) {
  }
});

引数

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

target

ターゲットオブジェクト

property

説明が検索されるプロパティ名.

descriptor

定義されたり変更されるプロパティに対する説明

戻り値

defineProperty メソッドには戻り値がありません。

説明

handler.defineProperty() メソッドはObject.defineProperty()に対するトラップです。

インターセプト

このトラップは下記の操作をインターセプトできます。:

• Object.defineProperty()
• Reflect.defineProperty()

不変条件

次の不変条件に違反している場合、プロキシはTypeErrorをスローします。:

• ターゲットオブジェクトが拡張可能でない場合、プロパティは追加されません。
• ターゲットオブジェクトの非設定独自のプロパティとして存在しない場合、プロパティは非設定であるとして追加されたり変更されたりできません。
• ターゲットオブジェクトの対応する構成可能なプロパティが存在する場合、プロパティは非設定でないかもしれません。
• プロパティが対応するターゲットオブジェクトを保つ場合、Object.defineProperty(target, prop, descriptor) は例外をスローしません。
• 厳格なモードでは、definePropertyハンドラからのfalse 戻り値はTypeError 例外をスローします。

例

次のコードはObject.defineProperty()をトラップします。

var p = new Proxy({}, {
  defineProperty: function(target, prop, descriptor) {
    console.log("called: " + prop);
    return true;
  }
});

var desc = { configurable: true, enumerable: true, value: 10 };
Object.defineProperty(p, "a", desc); // "called: a"

仕様

ブラウザ実装状況

関連情報

• Proxy
• handler
• Object.defineProperty()
• Reflect.defineProperty()