此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Reflect.preventExtensions()

基线 广泛可用

自 2016年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

静态方法 Reflect.preventExtensions() 方法阻止新属性添加到对象 (例如:防止将来对对象的扩展被添加到对象中)。该方法与 Object.preventExtensions()相似,但有一些不同点。详情可见 differences

尝试一下

const object1 = {};

console.log(Reflect.isExtensible(object1));
// Expected output: true

Reflect.preventExtensions(object1);

console.log(Reflect.isExtensible(object1));
// Expected output: false

语法

Reflect.preventExtensions(target)

参数

target

阻止扩展的目标对象。

返回值

返回一个 Boolean 值表明目标对象是否成功被设置为不可扩展。

异常

抛出一个 TypeError 错误,如果 target 不是 Object

描述

Reflect.preventExtensions 方法阻止新属性添加到对象 (例如:防止将来对对象的扩展被添加到对象中)。该方法与 Object.preventExtensions() 方法相似。

示例

使用 Reflect.preventExtensions()

详情可见 Object.preventExtensions().

js
// Objects are extensible by default.
var empty = {};
Reflect.isExtensible(empty); // === true

// ...but that can be changed.
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // === false

Object.preventExtensions() 的不同点

如果该方法的 target 参数不是一个对象(是原始值),那么将造成一个 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

浏览器兼容性

参见