preventextensions 是 proxy 拦截器,用于控制是否允许对代理对象调用 object.preventextensions();它接收 target 参数,必须返回布尔值,返回 true 表示放行并尝试设置目标不可扩展,返回 false 则立即抛出 typeerror。

preventExtensions 是 Proxy 的一个拦截器,用于控制目标对象是否能被设置为不可扩展(即禁止添加新属性)。当外部调用 Object.preventExtensions() 作用于代理对象时,该拦截器会被触发。它必须返回布尔值:返回 true 表示成功阻止扩展;返回 false 则会抛出 TypeError(除非目标对象本身已不可扩展且返回 true)。
preventExtensions 的基本用法
该拦截器接收一个参数:代理的目标对象(target)。你需要显式返回 true 或 false 来决定是否允许执行防止扩展操作。
- 若返回
true,Proxy 会接受该操作,并继续尝试对目标对象调用Object.preventExtensions(target) - 若返回
false,JS 引擎会立即抛出TypeError,且不会修改目标对象 - 注意:如果目标对象本身已不可扩展,你仍需返回
true,否则会报错
常见使用场景与写法
常用于权限控制、日志记录或封装只读容器的底层逻辑。
- 简单放行(默认行为):
preventExtensions: target => Object.preventExtensions(target) || true - 完全禁止扩展(无论目标状态如何):
preventExtensions: () => false(调用Object.preventExtensions(proxy)会直接报错) - 条件性拦截(例如仅在开发环境允许):
preventExtensions: target => process.env.NODE_ENV === 'development' ? Object.preventExtensions(target) : false
注意事项与陷阱
这个拦截器容易被忽略几个关键点:
- 它不控制属性是否可添加,只控制“是否能调用
preventExtensions”这一动作本身 - 即使拦截器返回
true,最终是否真正不可扩展,还取决于Object.preventExtensions(target)是否成功(比如 target 是密封对象或原始值时会失败) - 不能在拦截器里修改 target 的扩展性,只能决定是否让 JS 引擎去执行该操作
- 一旦目标对象被成功设为不可扩展,后续任何新增属性(如
obj.newProp = 1)在严格模式下会静默失败或抛错,这和 Proxy 的set拦截无关
完整示例:带日志的 preventExtensions 拦截
下面是一个记录调用并拒绝所有 preventExtensions 请求的代理:
const obj = { a: 1 };
const proxy = new Proxy(obj, {
preventExtensions(target) {
console.log('有人试图冻结对象扩展性');
return false; // 直接拒绝
}
});
Object.preventExtensions(proxy); // → TypeError: Cannot prevent extensions on proxy
console.log(Object.isExtensible(proxy)); // → true(未被修改)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











