Reflect.preventExtensions()

試してみましょう

const object = {};

console.log(Reflect.isExtensible(object));
// 予想される結果: true

Reflect.preventExtensions(object);

console.log(Reflect.isExtensible(object));
// 予想される結果: false

構文

Reflect.preventExtensions(target)

引数

target

拡張を抑止する対象のオブジェクト。

返値

論理値 (Boolean) で、対象が拡張の抑止の設定に成功したかどうかを表します。

例外

TypeError

target がオブジェクトではない場合に発生します。

解説

Reflect.preventExtensions() は、オブジェクトの拡張を防止する反射的意味づけを提供します。Object.preventExtensions() との相違点は以下の通りです。

• Reflect.preventExtensions() は、対象がオブジェクトでない場合に TypeError を発生させます。一方、Object.preventExtensions() は、オブジェクトでない対象を常にそのまま返します。
• Reflect.preventExtensions() は、ターゲットが拡張機能の防止に成功したかどうかを示す論理値 (Boolean) を返します。一方、Object.preventExtensions() はターゲットオブジェクトを返します。

Reflect.preventExtensions() は、target の [[PreventExtensions]] オブジェクト内部メソッド を呼び出します。

例

Reflect.preventExtensions() の使用

Object.preventExtensions() も参照してください。

// オブジェクトは既定で拡張可能。
const empty = {};
Reflect.isExtensible(empty); // true

// ...しかし、変更できる。
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // false

Object.preventExtensions() との違い

このメソッドへの最初の引数がオブジェクトではない (プリミティブである) 場合、 TypeError が発生します。 Object.preventExtensions() では、 target がオブジェクトではない場合はオブジェクトに強制的に変換されます。

Reflect.preventExtensions(1);
// TypeError: 1 is not an object

Object.preventExtensions(1);
// 1

仕様書

ブラウザーの互換性

関連情報

• Reflect.preventExtensions のポリフィル (core-js)
• Reflect
• Object.preventExtensions()
• handler.preventExtensions()