WeakSet 是仅存储对象的弱引用集合,不阻止垃圾回收,不可遍历,只提供 add、delete、has 方法,适用于临时标记、防重复操作等需自动清理的场景。
WeakSet 是 JavaScript 中一种特殊的集合类型,它只存储对象引用,且这些引用是“弱”的——不会阻止垃圾回收机制回收这些对象。
和 Set 不同,WeakSet 的 add() 方法只接受对象(包括函数、数组、普通对象等),传入 null、undefined、字符串、数字或布尔值会直接报错。这是因为 WeakSet 的设计目标就是配合对象生命周期管理,原始值本身没有引用计数问题,也不需要“弱引用”机制。
ws.add({})、ws.add(document.body)、ws.add(() => {})
ws.add("hello")、ws.add(42)、ws.add(null)
所谓“弱”,是指 WeakSet 持有的对象引用不会被计入 JavaScript 引擎的垃圾回收判定条件。如果一个对象只被 WeakSet 引用,而其他地方都不再持有它的引用,那么这个对象就会被自动回收,WeakSet 内部也会随之失去对该对象的记录(不需要手动清理)。
这使得 WeakSet 天然适合做“临时标记”:比如你想知道某个 DOM 元素是否已被处理过,又不想因为标记本身阻止元素被卸载。
使元素从 DOM 中移除,只要 Set 还持有引用,该对象就无法被回收,可能造成内存泄漏WeakSet 没有 keys()、values()、entries(),也没有 forEach 方法,也不能用 for...of 遍历。它只提供三个方法:
add(value) —— 添加一个对象delete(value) —— 删除指定对象(返回布尔值)has(value) —— 判断是否包含某对象(返回布尔值)这种限制不是缺陷,而是刻意为之:避免开发者试图“读取全部内容”,从而干扰弱引用的设计初衷。你只能问“它有没有这个对象”,不能问“它有哪些对象”。
WeakSet 常用于不污染对象自身、也不影响内存回收的轻量级标记场景:
它不替代 Set,也不追求通用性,而是在特定边界下解决“临时关联 + 自动清理”这一类问题。