Proxy 无法拦截 Object.freeze() 调用,但可通过 set/defineProperty/deleteProperty 等 trap 返回 false 并统一返回不可配置不可写的 descriptor 来模拟冻结行为;不能代理已冻结对象,须先创建 Proxy 再模拟冻结;递归冻结需在 get 中处理嵌套对象并用 WeakMap 防循环引用。

Proxy 本身不能直接拦截 Object.freeze() 这类“冻结操作”,因为 Object.freeze 是一个全局方法,它作用于目标对象并返回该对象——它不触发 Proxy 的任何 trap。换句话说:冻结动作本身不会经过 Proxy,你无法用 Proxy “捕获” freeze 调用。
真正能拦截的是“冻结后的行为”
虽然不能拦截 freeze 调用,但你可以用 Proxy 模拟或强化冻结效果,即:在代理层阻止后续所有修改操作,并统一反馈“已冻结”。关键不是监听 freeze,而是让代理对象表现得像已被冻结一样。
- set、defineProperty、deleteProperty 等 trap 返回
false(严格模式下抛错),模拟不可写/不可配置 - getOwnPropertyDescriptor 返回
{ configurable: false, writable: false }对所有自有属性 - ownKeys 和 getOwnPropertyNames 保持原样,但配合 descriptor 实现语义一致
- 对原型链上的属性不干预,只约束目标对象自身行为
浅层冻结代理的典型写法
下面是一个可复用的冻结式 Proxy 创建函数:
安全更新和维护 CLI Proxy API(CPA)部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
(注意:它不调用 Object.freeze,而是靠 trap 行为达成等效效果)
- set → 总是返回
false,拒绝任何赋值 - defineProperty / setPrototypeOf → 返回
false,禁止结构变更 - deleteProperty → 返回
false,禁止删除 - getOwnPropertyDescriptor → 对每个自有属性强制返回不可配置、不可写
- preventExtensions → 返回
true,且后续 ownKeys 不允许新增
为什么不能代理已冻结对象?
如果先调用 Object.freeze(obj),再对它套 Proxy,会失败——因为冻结后的对象不允许添加新属性,而 Proxy 内部需要设置一些隐藏标识(如 [[ProxyHandler]]),这违反了不可扩展性。浏览器会直接抛出 TypeError: can't define property "xxx": object is not extensible。
- 正确顺序:先创建 Proxy,再用它的行为模拟冻结;不要对已冻结对象再代理
- 若需兼容原生冻结语义,应在创建 Proxy 时就内置冻结逻辑,而非事后补救
- 想检测是否“被冻结”,可在 handler 中维护一个内部标志位(如
isFrozen = true),由外部逻辑控制
递归冻结嵌套对象的注意事项
Proxy 默认只代理一层。若目标对象含嵌套对象,它们不会自动被冻结式代理包裹。
- 需在 get trap 中判断返回值是否为对象,若是则递归 wrap 成新的冻结代理
- 要避免循环引用导致栈溢出,可用 WeakMap 缓存已代理过的对象
- 注意函数、Date、RegExp 等特殊对象不能被冻结式代理安全包裹(如 Date 方法依赖 this 指向原始实例)

















