WeakMap 的键只能是对象,原始值会报错;它不阻止垃圾回收,而 Map 会强引用锁住对象;WeakMap 不支持遍历、size、clear 等操作,适用于为对象附加私有元数据。

WeakMap 的键只能是对象,原始值会直接报错
如果你尝试用字符串、数字或布尔值作为 WeakMap 的键,JavaScript 会立刻抛出 TypeError: Invalid value used as weak map key。这不是运行时隐式转换,而是硬性限制。
原因在于:弱引用机制依赖于对象在内存中的身份(即引用地址),而原始值没有“引用”概念,它们按值传递、不可被 GC 追踪。
const wm = new WeakMap();wm.set({}, 'ok'); // ✅ 正常wm.set([], 'array'); // ✅ 数组也是对象wm.set(function(){}, 'fn'); // ✅ 函数也是对象wm.set('str', 'bad'); // ❌ 报错wm.set(42, 'bad'); // ❌ 报错
WeakMap 不阻止垃圾回收,Map 会锁住对象不释放
这是两者最本质的差异,直接影响内存行为。当你把一个对象存进 Map,它就「被记住了」——哪怕你把原变量设为 null,只要 Map 还活着,这个对象就一直占着内存;而 WeakMap 不会干涉 GC,对象一旦失去所有其他引用,就会被回收,对应条目也自动消失。
const map = new Map(); const wm = new WeakMap();let obj = { id: 1 }; map.set(obj, 'from map'); wm.set(obj, 'from weakmap');
obj = null; // 切断外部引用
// 此时: // - map 中仍能查到该对象(强引用锁住) // - wm 中已无法访问(obj 被 GC 后条目自动清理) // 注意:GC 时机不可控,但行为确定 —— 你不需手动 delete
常见踩坑:误以为 WeakMap 是“轻量版 Map”,结果在需要长期持有数据的场景(比如全局缓存)用了它,导致数据莫名消失。
Unix in a Nutshell同时涵盖了许多重要的、业界标准的开放源码工具 本书还完整地讨论了常用的shell(bash、ksh及tcsh)和重要元素如正则表达式,乃至旧式工具如sed、awk与vi。 Unix不是一个庞大的物体:它是一个综合体,而《Unix技术手册》则是将这一切合并在一起的一本书。 到底unix是什么?原始的unix源码是由sco拥有,unix注册商标是由open group拥有,而领先的仿unix系统则是gnu/linux、mac os x及solaris。这些版本所附的命令与选
WeakMap 不支持遍历、size 和 clear,也没 get 方法
WeakMap 没有 keys()、values()、entries()、forEach(),也没有 size 属性,甚至没有 get() 方法(等等,它其实有 —— 但文档里写的是有,实际 API 是存在的;不过重点是它不支持任何枚举手段)。
- 不能用
for...of遍历 - 不能通过
wm.size查数量(返回undefined) - 不能调用
wm.clear()(该方法不存在) - 不能初始化时传数组:
new WeakMap([[{}, 'val']])会报错
这些限制不是疏漏,而是设计选择:确保附加在对象上的元数据真正“私有”——外部代码无法探测、枚举或批量操作。
典型用途:给 DOM 元素或类实例加私有状态,不干扰生命周期
最常见的安全用法,就是把临时、附属性的数据和某个对象绑定,又不想让它阻碍回收。比如:
- 为第三方 DOM 元素添加自定义配置,页面卸载后自动清理
- 在类中模拟私有字段(ES6 class 不支持真正的私有属性时)
- 实现基于对象身份的缓存(如
computeExpensive(obj)结果只对这个obj有效)
const elementCache = new WeakMap();function getCachedData(el) { if (!elementCache.has(el)) { elementCache.set(el, expensiveParse(el)); } return elementCache.get(el); }
// el 移除后,elementCache 自动丢弃对应条目,无泄漏
注意:别指望用 WeakMap 做通用缓存或配置中心 —— 它的不可遍历性和弱引用特性,决定了它只适合“依附于对象存在”的场景。一旦你需要主动管理、统计或调试内容,Map 才是正解。










