The Reflect.preventExtensions()
static method is like Object.preventExtensions()
. It prevents new properties from ever being added to an object (i.e., prevents future extensions to the object).
The Reflect.preventExtensions()
static method is like Object.preventExtensions()
. It prevents new properties from ever being added to an object (i.e., prevents future extensions to the object).
Reflect.preventExtensions(target)
target
The target object on which to prevent extensions.
A Boolean
indicating whether or not the target was successfully set to prevent extensions.
TypeError
Thrown if target
is not an object.
Reflect.preventExtensions()
provides the reflective semantic of preventing extensions of an object. The differences with Object.preventExtensions()
are:
Reflect.preventExtensions()
throws a TypeError
if the target is not an object, while Object.preventExtensions()
always returns non-object targets as-is.Reflect.preventExtensions()
returns a Boolean
indicating whether or not the target was successfully set to prevent extensions, while Object.preventExtensions()
returns the target object.Reflect.preventExtensions()
invokes the [[PreventExtensions]]
object internal method of target
.
See also Object.preventExtensions()
.
// Objects are extensible by default. const empty = {}; Reflect.isExtensible(empty); // true // ...but that can be changed. Reflect.preventExtensions(empty); Reflect.isExtensible(empty); // false
If the target
argument to this method is not an object (a primitive), then it will cause a TypeError
. With Object.preventExtensions()
, a non-object target
will be returned as-is without any errors.
Reflect.preventExtensions(1); // TypeError: 1 is not an object Object.preventExtensions(1); // 1
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
preventExtensions |
49 | 12 | 42 | 36 | 10 | 49 | 42 | 36 | 10 | 5.0 | 49 | 1.0 | 6.0.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/preventExtensions