Reflect.preventExtensions()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。
Reflect.preventExtensions() は静的メソッドで、Object.preventExtensions() に似ています。すでにプロパティが追加されたオブジェクトに、新しいプロパティを抑制します (つまり、オブジェクトのさらなる拡張を抑制します)。
試してみましょう
const object = {};
console.log(Reflect.isExtensible(object));
// 予想される結果: true
Reflect.preventExtensions(object);
console.log(Reflect.isExtensible(object));
// 予想される結果: false
構文
js
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() も参照してください。
js
// オブジェクトは既定で拡張可能。
const empty = {};
Reflect.isExtensible(empty); // true
// ...しかし、変更できる。
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // false
Object.preventExtensions() との違い
このメソッドへの最初の引数がオブジェクトではない (プリミティブである) 場合、 TypeError が発生します。 Object.preventExtensions() では、 target がオブジェクトではない場合はオブジェクトに強制的に変換されます。
js
Reflect.preventExtensions(1);
// TypeError: 1 is not an object
Object.preventExtensions(1);
// 1
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-reflect.preventextensions |