WeakMap 是 JavaScript 中一种特殊的键值对集合，它与普通的 Map 类似，但有一些关键区别，主要围绕着键的引用方式和内存管理。理解 WeakMap 的核心在于它的名字中的 “Weak”（弱）。
以下是 WeakMap 的核心特性和概念：
- 键必须是对象：
- 这是最重要的区别。WeakMap 的 键（Key） 只能是 对象（Object） 或 Symbol（从 ES2023 开始支持 Symbol 作为键）。你不能使用原始值（如字符串、数字、布尔值、null、undefined）作为 WeakMap 的键。
- 普通的 Map 则允许任何类型的值作为键（包括对象和原始值）。
- 弱引用：
- 这是 WeakMap 得名的原因，也是它最重要的特性。
- WeakMap 对其键（对象）持有的是 弱引用（Weak Reference）。
- 这意味着：如果一个对象作为 WeakMap 的键存在，并且这个对象在程序的其他地方不再被任何强引用指向（即没有任何变量、属性或其他强引用集合（如数组、普通 Map 或 Set）引用它），那么 JavaScript 的垃圾回收器（Garbage Collector）可以自动回收这个对象所占用的内存，即使它还在 WeakMap 中充当键。
- 当键对象被垃圾回收后，它对应的整个键值对也会自动从 WeakMap 中消失。
- 不可枚举：
- WeakMap 没有提供像 keys(), values(), entries() 这样的方法来遍历其键或值。
- 它也 没有 size 属性让你知道里面有多少个键值对。
- 这是设计使然，因为弱引用的本质决定了 WeakMap 的内容随时可能因垃圾回收而改变，无法保证稳定的遍历结果。
- 主要用途：
- 正是由于弱引用的特性，WeakMap 的主要用途是存储与特定对象关联的 “元数据” 或 “私有数据”，而这些数据的生命周期应该与对象本身的生命周期紧密绑定。
- 避免内存泄漏： 这是使用 WeakMap 的最大优势。想象一下，如果你用一个普通 Map 来存储对象（键）和它的附加数据（值），即使你不再需要这个对象本身了（没有其他引用），只要这个 Map 还存在，这个对象作为键就会被 Map 强引用着，垃圾回收器就无法回收它，造成内存泄漏。WeakMap 解决了这个问题。
- 常见场景：
- 为 DOM 节点存储附加数据（例如事件处理器、状态标记）。当 DOM 节点被从文档中移除并被垃圾回收后，存储在 WeakMap 中的关联数据也会自动被清除。
- 为类实例存储私有数据（尤其是在 ES6 类中模拟真正的私有性）。将私有数据以实例对象为键存储在 WeakMap 中，外部代码无法直接访问 WeakMap 和其中的数据。
- 缓存计算结果，但希望当原始对象不再需要时缓存也能自动失效。
- API (方法):
- new WeakMap([iterable]): 创建一个新的 WeakMap。可选的 iterable 参数（例如包含 [key, value] 数组的数组）用于初始化。
- .set(key, value): 设置键 key（必须是对象或 Symbol）对应的值 value。返回这个 WeakMap 本身（支持链式调用）。
- .get(key): 读取键 key 对应的值。如果键不存在（或已被回收），则返回 undefined。
- .has(key): 检查 WeakMap 中是否存在键 key。返回布尔值。
- .delete(key): 删除键 key 及其对应的值。如果该键存在并成功删除则返回 true，否则返回 false。
与 Map 的对比总结：
| 特性 | WeakMap | Map |
|---|---|---|
| 键类型 | 仅限对象 (Object) 或 Symbol | 任意值 (对象、原始值) |
| 键引用 | 弱引用 | 强引用 |
| 垃圾回收 | 键对象无其他引用时自动回收，键值对消失 | 键对象即使无其他引用，只要在 Map 中就不会被回收 |
| 可枚举性 | 不可枚举 (无 keys/values/entries/size) | 可枚举 (有 keys/values/entries/size) |
| 主要用途 | 存储与对象生命周期绑定的元数据/私有数据，避免内存泄漏 | 通用键值存储，需要遍历或任意键类型时使用 |
简单示例：
let obj1 = { name: "Alice" };
let obj2 = { name: "Bob" };// 使用 WeakMap
const weakMap = new WeakMap();
weakMap.set(obj1, "Secret data for Alice");
weakMap.set(obj2, "Secret data for Bob");console.log(weakMap.get(obj1)); // 输出: "Secret data for Alice"// 移除对 obj1 的所有强引用
obj1 = null; // 现在只有 weakMap 对它有一个弱引用// 在未来的某个时刻（不确定何时），垃圾回收器会回收 obj1 的内存...
// ...同时，weakMap 中对应的键值对也会自动消失。// 使用 Map (对比内存泄漏)
const map = new Map();
map.set(obj2, "Data held strongly for Bob");obj2 = null; // 移除了对 obj2 的唯一强引用...// ...但是 obj2 仍然作为 map 的键被强引用着，不会被垃圾回收！(内存泄漏)
总结：
WeakMap 是一种特殊的键值对集合，它只接受对象或 Symbol 作为键，并且对这些键持有弱引用。这意味着当键对象在程序的其他地方不再被使用时（没有其他强引用指向它），垃圾回收器可以自动回收该对象，并且它对应的键值对也会随之从 WeakMap 中消失。这种特性使得 WeakMap 非常适合用于存储与对象生命周期紧密关联的附加数据（如 DOM 节点数据、类实例的私有数据），从而有效避免内存泄漏。它不可枚举，也没有 size 属性。当你需要这种自动清理关联数据的功能时，就应该考虑使用 WeakMap 而不是普通的 Map。