Reflect.defineProperty()

静的なReflect.defineProperty()メソッドは、Object.defineProperty()と似ていますが、Booleanを返します。

構文

Reflect.defineProperty(target, propertyKey, attributes)

パラメータ

target

プロパティを定義する対象のオブジェクト。

propertyKey

定義または修正をするプロパティ名。

attributes

定義または修正されているプロパティのための属性。.

戻り値

プロパティが成功裏に定義されたかどうかを示すBoolean。

エラーのスロー

targetがObjectではなかった場合、TypeErrorをスローする。

説明

Reflect.definePropertyメソッドは、オブジェクトのプロパティの正確な追加や修正を行います。詳細は、類似しているメソッドであるObject.definePropertyを見てください。 Object.definePropertyはプロパティが成功裏に定義できなかった場合、オブジェクトを返すかTypeErrorをスローします。しかし、Reflect.definePropertyは単純に、プロパティが成功裏に定義されたかどうかを示すBooleanを返します。

例

Reflect.defineProperty()の使用

var obj = {};
Reflect.defineProperty(obj, "x", {value: 7}); // true
obj.x; // 7

プロパティ定義が成功したかチェックする

成功してオブジェクトを返すか、失敗してTypeErrorをスローするObject.definePropertyを使う場合、プロパティの定義中に発生する何らかの例外をキャッチするには、try...catchブロックを使用します。 Reflect.definePropertyはBooleanの成功ステータスを返すので、if...elseブロックを使えます:

if (Reflect.defineProperty(target, property, attributes)) {
  // success
} else {
  // failure
}

仕様

ブラウザ実装状況

関連項目

• Reflect
• Object.defineProperty()