Object.preventExtensions 使对象不可新增属性但允许修改、删除和重配置已有属性;调用后 extensible 变为 false,可用 Object.isExtensible 检测;它不等同于密封或冻结,常用于初始化后锁定结构。

Object.preventExtensions 能让一个对象“冻结”新增属性的能力,即之后无法再添加新属性,但已有的属性仍可修改、删除或重新配置。
基本用法很简单
直接传入目标对象即可:
- Object.preventExtensions(obj) 返回该对象本身(不是副本)
- 调用后,obj 的 extensible 属性变为 false
- 尝试用 obj.newProp = value 或 Object.defineProperty 添加新属性会静默失败(非严格模式)或抛出 TypeError(严格模式)
如何检测对象是否已被禁止扩展
用 Object.isExtensible(obj) 判断:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 返回 true 表示还能加属性
- 返回 false 表示已调用 preventExtensions 或原本就不可扩展(如内置对象)
注意它不等于“只读”或“密封”
它只限制新增属性,其他操作依然允许:
立即学习“Java免费学习笔记(深入)”;
- 已有属性的值可以修改:obj.existing = 'new'
- 已有属性可以删除:delete obj.existing
- 已有属性描述符可以更改(如设为 writable: false),前提是它原本可配置
- 若想进一步锁定,需配合 Object.seal(禁止删改属性)或 Object.freeze(完全只读)
常见使用场景
适合在对象初始化完成后、对外暴露前做一次“收口”:
- 构造函数末尾调用,防止用户意外添加属性
- 配置对象生成后锁定结构,避免后续误操作破坏约定
- 与 Object.defineProperty 配合,先定义好所有属性,再禁止扩展

















