WeakMap 是为对象附加私有数据的理想工具，因其键必须是对象、弱引用不阻止垃圾回收、外部无法遍历，天然避免命名冲突和内存泄漏，特别适合第三方库对象。
WeakMap 是 JavaScript 中为对象附加私有数据的理想工具，尤其适合第三方库对象——它不阻止对象被垃圾回收，也不会暴露数据到对象自身属性上，天然避免命名冲突和内存泄漏。
为什么 WeakMap 适合第三方对象
第三方库创建的对象你通常无法修改原型或添加自有属性（比如 DOM 元素、React 组件实例、Moment.js 对象等），直接挂属性可能污染对象、引发冲突，或在对象销毁后残留数据。WeakMap 的键必须是对象，且是弱引用：只要该对象没有其他强引用，即使它还在 WeakMap 中，也能被正常回收。
- 键只能是对象（不能是字符串或数字），天然匹配“为某对象存数据”的场景
- 不阻止垃圾回收——这是和 Map 的核心区别
- 外部无法遍历或访问 WeakMap 内容，数据真正私有
基础用法：用 WeakMap 存储私有元数据
先创建一个模块级 WeakMap 实例，然后用目标对象作键存值：
const privateData = new WeakMap();
// 为任意第三方对象附加数据
function attachConfig(obj, config) {
privateData.set(obj, { ...config, createdAt: Date.now() });
}
function getConfig(obj) {
return privateData.get(obj);
}
// 使用示例（假设 moment 是第三方库）
const now = moment();
attachConfig(now, { locale: 'zh-cn', format: 'YYYY-MM-DD' });
console.log(getConfig(now)); // { locale: 'zh-cn', ..., createdAt: 171... }
注意：WeakMap 必须在闭包或模块作用域内持有（不能暴露出去），否则私有性就失效了。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记（深入）”；
配合类封装，模拟真正的私有字段
你可以把 WeakMap 封装进类中，让每个实例的私有状态完全隔离：
class EnhancedLogger {
static #store = new WeakMap();
constructor(targetObj) {
EnhancedLogger.#store.set(targetObj, {
logCount: 0,
lastLogTime: 0
});
}
log(msg) {
const data = EnhancedLogger.#store.get(this.target);
data.logCount++;
data.lastLogTime = Date.now();
console.log(`[${data.logCount}] ${msg}`);
}
getStats() {
return EnhancedLogger.#store.get(this.target);
}
}
这样，即使传入的是第三方构造的实例（如 new Date() 或 document.body），也能安全附加强类型私有状态，且不影响原对象。
实际注意事项与常见陷阱
WeakMap 看似简单，但几个细节决定能否稳定使用：
- WeakMap 实例必须长期持有（比如模块顶层变量），否则它自己被回收，所有映射就丢了
- 不能用原始值（string/number）作键——如果需要为字符串 ID 存数据，得先用 Map 或其它结构
- 无法检测键是否存在（
has()可用，但无法枚举），设计时要接受“只读+按需取”模式 - 若第三方对象是临时创建又频繁丢弃（如 React 函数组件内的局部对象），WeakMap 自动清理正是优势所在
