From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../object/preventextensions/index.html | 129 +++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/object/preventextensions/index.html (limited to 'files/ja/web/javascript/reference/global_objects/object/preventextensions') diff --git a/files/ja/web/javascript/reference/global_objects/object/preventextensions/index.html b/files/ja/web/javascript/reference/global_objects/object/preventextensions/index.html new file mode 100644 index 0000000000..a9c97dd29b --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/object/preventextensions/index.html @@ -0,0 +1,129 @@ +--- +title: Object.preventExtensions() +slug: Web/JavaScript/Reference/Global_Objects/Object/preventExtensions +tags: + - ECMAScript 5 + - JavaScript + - JavaScript 1.8.5 + - Method + - Object +translation_of: Web/JavaScript/Reference/Global_Objects/Object/preventExtensions +--- +
{{JSRef}}
+ +

Object.preventExtensions() メソッドはすでにプロパティが追加されたオブジェクトで、新しいプロパティを抑制します (すなわち、オブジェクトのさらなる拡張を抑制します)。

+ +
{{EmbedInteractiveExample("pages/js/object-preventextensions.html")}}
+ + + +

構文

+ +
Object.preventExtensions(obj)
+ +

引数

+ +
+
obj
+
拡張を不可能にしたいオブジェクトです。
+
+ +

返値

+ +

拡張不可能にされたオブジェクトです。

+ +

解説

+ +

新しいプロパティを追加できる場合、オブジェクトは拡張可能です。 Object.preventExtensions() はオブジェクトを拡張不可能と標示することで、その時点で持っているプロパティ以外のプロパティを持たせることを不可能にします。拡張不可能なオブジェクトのプロパティは通常、依然として削除できることに注意してください。拡張不可能なオブジェクトへ新たにプロパティを追加しようとしても、暗黙的あるいは {{jsxref("TypeError")}} エラーを発生させて失敗します (通常は {{jsxref("Functions_and_function_scope/Strict_mode", "strict mode", "", 1)}} において、ただしこれに限定はされません)。

+ +

Object.preventExtensions() は、自身のプロパティの追加のみを抑制します。オブジェクトプロトタイプにプロパティを追加することは可能です。

+ +

このメソッドは対象の [[prototype]] を不変にし、それ以降のあらゆる [[prototype]] への再代入は {{jsxref("TypeError")}} を発生します。この動作は [[prototype]] 内部プロパティ固有のものであり、他のプロパティは変更可能なままです。

+ +

拡張可能なオブジェクトを拡張不可能にする方法はありますが、逆の方法はありません。

+ +

例

+ +

Object.preventExtensions の使用

+ +
// Object.preventExtensions は拡張不可能にしたオブジェクトを返します
+var obj = {};
+var obj2 = Object.preventExtensions(obj);
+obj === obj2; // true
+
+// 既定でオブジェクトは拡張可能です
+var empty = {};
+Object.isExtensible(empty); // === true
+
+// この性質は変更できます
+Object.preventExtensions(empty);
+Object.isExtensible(empty); // === false
+
+// Object.defineProperty で拡張不可能なオブジェクトに
+// 新しいプロパティを追加する際、エラーが発生します
+var nonExtensible = { removable: true };
+Object.preventExtensions(nonExtensible);
+Object.defineProperty(nonExtensible, 'new', {
+  value: 8675309
+}); // TypeError が発生
+
+// 厳格モードでは、拡張不可能なオブジェクトに
+// 新たなプロパティを追加しようとすると TypeError が発生します
+function fail() {
+  'use strict';
+  // TypeError が発生
+  nonExtensible.newProperty = 'FAIL';
+}
+fail();
+
+ +

拡張不可能なオブジェクトのプロトタイプは不変になります。

+ +
var fixed = Object.preventExtensions({});
+// TypeError が発生
+fixed.__proto__ = { oh: 'hai' };
+ +

オブジェクト以外の型強制

+ +

ES5 では、このメソッドの引数がオブジェクトではない場合 (プリミティブの場合)、 {{jsxref("TypeError")}} が発生します。 ES2015 以降では、オブジェクトでない引数は、それが拡張不可能な通常のオブジェクトであるかのように扱われ、単にそれを返します。

+ +
Object.preventExtensions(1);
+// TypeError: 1 is not an object (ES5 code)
+
+Object.preventExtensions(1);
+// 1                             (ES2015 code)
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-object.preventextensions', 'Object.preventExtensions')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Object.preventExtensions")}}

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf