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

View in English Always switch to English

Reflect.preventExtensions()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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

规范

Specification
ECMAScript® 2026 Language Specification
# sec-reflect.preventextensions

浏览器兼容性

参见