Reflect.getOwnPropertyDescriptor()

静的な Reflect.getOwnPropertyDescriptor() メソッドは、Object.getOwnPropertyDescriptor() と似ています。オブジェクトにプロパティが存在する場合、与えられたプロパティのプロパティディスクリプタを返します。一方、プロパティが存在しない場合は、undefined を返します。

構文

Reflect.getOwnPropertyDescriptor(target, propertyKey)

パラメータ

target

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

propertyKey

自身のプロパティディスクリプタを取得するためのプロパティ名。

戻り値

プロパティディスクリプタオブジェクト、または undefined。

スローされるエラー

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

説明

Reflect.getOwnPropertyDescriptor オブジェクトにプロパティが存在する場合、与えられたプロパティのプロパティディスクリプタを返します。一方、プロパティが存在しない場合は、undefined を返します。Object.getOwnPropertyDescriptor() との唯一の違いは、非オブジェクトの対象がどのようにバンドルされるかだけです。

例

Reflect.getOwnPropertyDescriptor() を使用する

Reflect.getOwnPropertyDescriptor({x: "hello"}, "x");
// {value: "hello", writable: true, enumerable: true, configurable: true}

Reflect.getOwnPropertyDescriptor({x: "hello"}, "y");
// undefined

Reflect.getOwnPropertyDescriptor([], "length");
// {value: 0, writable: true, enumerable: false, configurable: false}

Object.getOwnPropertyDescriptor() との違い

このメソッドへの最初の引数がオブジェクトではない（プリミティブ）場合、TypeError が引き起こされます。Object.getOwnPropertyDescriptor だと、非オブジェクトである最初の引数は強制的にオブジェクトに変換されます。

Reflect.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" は非 null オブジェクトではない

Object.getOwnPropertyDescriptor("foo", 0);
// { value: "f", writable: false, enumerable: true, configurable: false }

仕様

ブラウザ実装状況

関連項目

• Reflect
• Object.getOwnPropertyDescriptor()