Proxy可实现深度不可变,通过拦截set、defineProperty等操作并递归代理嵌套对象,配合WeakMap避免重复代理,但存在性能开销和相等性问题,需权衡使用。

要让对象的所有属性不可变,不能只靠 Object.freeze() —— 它只冻结对象自身属性,不递归冻结嵌套对象,也不阻止新增属性(在严格模式下会静默失败)。而 Proxy 可以真正拦截所有操作,实现“深度不可变”的语义。但注意:Proxy 本身不修改原对象,只是拦截访问;真正的不可变需配合拒绝写操作的 trap。
用 Proxy 拦截所有写操作(set、defineProperty、deleteProperty)
核心是捕获赋值、定义属性、删除属性等行为,并统一抛错或忽略:
-
set:拦截
obj.prop = value和obj[prop] = value -
defineProperty:拦截
Object.defineProperty(obj, ...) -
deleteProperty:拦截
delete obj.prop - setPrototypeOf:防止修改原型(可选,增强防护)
示例:
const immutable = (target) => new Proxy(target, {set() { throw new TypeError('Cannot modify immutable object'); },
defineProperty() { throw new TypeError('Cannot define property on immutable object'); },
deleteProperty() { throw new TypeError('Cannot delete property from immutable object'); },
setPrototypeOf() { throw new TypeError('Cannot change prototype of immutable object'); }
});
const obj = immutable({ a: 1, b: { c: 2 } });
obj.a = 99; // 抛错
obj.b.c = 99; // 同样抛错 —— 因为 b 也是被 Proxy 包裹的对象
递归冻结嵌套对象(深度不可变)
上面的 immutable 函数只代理顶层对象。若属性值本身是对象,需递归代理它们,否则嵌套属性仍可被修改。
- 在
gettrap 中对返回的 object 类型值自动包装为immutable - 避免重复代理(用 WeakMap 缓存已代理对象)
- 基本类型(string/number/boolean/null/undefined)直接返回,不代理
const immutable = (target) => {
if (typeof target !== 'object' || target === null) return target;
if (immutables.has(target)) return immutables.get(target);
const handler = {
get(obj, prop) {
const val = obj[prop];
return typeof val === 'object' && val !== null ? immutable(val) : val;
},
set() { throw new TypeError('Cannot modify immutable object'); },
defineProperty() { throw new TypeError('Cannot define property on immutable object'); },
deleteProperty() { throw new TypeError('Cannot delete property from immutable object'); },
setPrototypeOf() { throw new TypeError('Cannot change prototype of immutable object'); }
};
const proxy = new Proxy(target, handler);
immutables.set(target, proxy);
return proxy;
};
注意:Proxy 不等于 Object.freeze,也不替代 const
const 只保证绑定不变,不保证值不可变;Object.freeze 是浅冻结且无法拦截运行时操作。Proxy 提供的是运行时拦截能力,但有代价:
- 每次属性访问都有额外开销(性能敏感场景慎用)
- 代理对象与原对象不全等(
proxy === original为 false) - 某些底层操作(如
Array.isArray(proxy))仍返回 true,但proxy instanceof Array可能失效(需在 handler 中补getOwnPropertyDescriptor等 trap)
更实用的方案:结合 freeze + Proxy 做轻量防护
若只需防误改、不要求 100% 拦截(比如开发环境警告),可用更轻量的方式:
- 先
Object.freeze所有自有属性和嵌套对象(递归) - 再用 Proxy 拦截
set/defineProperty,仅在非严格模式下提供友好提示 - 避免递归代理,减少内存与性能开销
不复杂但容易忽略:真正“不可变”是语义目标,Proxy 是达成它的工具之一,关键在于明确拦截哪些操作、是否递归、以及如何处理边界情况(如函数、日期、正则等特殊对象)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











