weakmap 是 javascript 中唯一能安全为对象附加私有元数据且不阻止垃圾回收的机制，因其键必须是对象、弱引用语义和外部不可访问性，成为 proxy 模式中管理私有状态（如访问计数、锁定标记）的不可替代方案。
WeakMap 是 JavaScript 中唯一能安全为对象附加私有元数据、且不阻止其被垃圾回收的机制——这正是它在 Proxy 模式中不可替代的原因。
为什么 WeakMap 适合 Proxy 中的私有元数据
Proxy 的 handler（如 get、set）常需访问目标对象的额外状态（如访问计数、冻结标记、内部缓存），但又不能污染目标对象本身（避免属性名冲突、不暴露给外部、不干扰 for...in 或 JSON.stringify）。WeakMap 天然满足三个关键要求：
-
键必须是对象：可直接用
target作键，精准绑定元数据到具体实例； - 弱引用语义：当 target 被销毁时，对应条目自动释放，无内存泄漏风险；
- 外部不可访问：WeakMap 实例本身不暴露键列表，也无法通过目标对象反查元数据。
典型用法：为代理对象添加不可枚举、不可篡改的私有状态
下面是一个带访问计数和只读锁定的 Proxy 示例，所有状态都通过 WeakMap 隔离：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
const privateState = new WeakMap();
function createTrackedReadOnlyProxy(target) {
// 初始化私有状态（仅首次访问时创建）
if (!privateState.has(target)) {
privateState.set(target, { accessCount: 0, isLocked: false });
}
return new Proxy(target, {
get(obj, prop, receiver) {
const state = privateState.get(obj);
state.accessCount++; // 安全更新
return Reflect.get(obj, prop, receiver);
},
set(obj, prop, value, receiver) {
const state = privateState.get(obj);
if (state.isLocked) throw new TypeError('Object is locked');
return Reflect.set(obj, prop, value, receiver);
},
defineProperty(obj, prop, descriptor) {
const state = privateState.get(obj);
if (state.isLocked) throw new TypeError('Object is locked');
return Reflect.defineProperty(obj, prop, descriptor);
}
});
}
// 使用
const obj = { x: 1 };
const proxy = createTrackedReadOnlyProxy(obj);
proxy.x; // accessCount → 1
proxy.y = 2; // OK
proxy.x = 99; // OK
privateState.get(obj).isLocked = true;
proxy.z = 3; // TypeError: Object is locked
关键细节与注意事项
实际使用中需注意以下几点，否则可能失效或引发意外：
- WeakMap 必须在闭包/模块作用域内持有：不能暴露给外部，否则别人可通过 WeakMap 实例反向操作状态；
-
不要在 Proxy handler 外部直接修改 WeakMap 条目：应封装访问逻辑（如提供
lock(obj)工具函数），保持状态一致性； - 无法对原始值（string/number/symbol）使用 WeakMap：Proxy 目标只能是对象，所以天然兼容；
- WeakMap 不支持迭代和清除全部条目：这是设计使然，也是安全性的一部分——你无法“扫描”哪些对象被代理过。
进阶技巧：组合多个 WeakMap 管理不同关注点
一个代理可能需要多种元数据（如校验规则、序列化策略、调试标签）。推荐按职责拆分 WeakMap，而非塞进一个大对象：
const validationRules = new WeakMap(); // { target → Map<prop validator> }
const serializationHints = new WeakMap(); // { target → { omit: [...], rename: {...} } }
const debugLabels = new WeakMap(); // { target → string }
// 各自独立、互不干扰，也便于单元测试和按需加载
</prop>
这样既保持关注点分离，又避免单个 WeakMap 值对象变得臃肿难维护。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
