JavaScript WeakMap是什么_它有什么特殊用途

夜晨 2026-01-06 00:00:00 次阅读

WeakMap 是唯一不阻止垃圾回收的键值结构，专为元数据绑定设计；键必须是对象且为弱引用，无 size、遍历、清空等方法，无法序列化或调试。

WeakMap 是 JavaScript 中唯一能“附着数据却不拖住对象”的键值结构——它不阻止垃圾回收，专为元数据绑定而生。

为什么不能用普通 Map 存 DOM 元信息？

当你用 Map 给 DOM 节点存状态时，哪怕节点已被 remove()、页面也跳转了，只要它还在 Map 里，引擎就认为“还有引用”，无法回收。结果就是内存悄悄涨上去，DevTools 里看到大量 detached DOM 节点残留。

而 WeakMap 的键是弱引用：只要节点在 JS 代码里没其他变量指向它，GC 就能立刻收走，WeakMap 里对应的条目也自动消失。

✅ 正确做法：

const nodeMeta = new WeakMap();
const el = document.getElementById('app');
nodeMeta.set(el, { lastClick: Date.now(), isExpanded: true });
// el 被 remove() 后，nodeMeta 中该条目不可访问，也不占内存

❌ 错误做法：const map = new Map(); map.set(el, ...) —— 节点变“永生”
⚠️ 注意：WeakMap 的键必须是对象，nodeMeta.set('div#app', ...) 会直接报 TypeError: Invalid value used as weak map key

怎么用 WeakMap 模拟类的私有属性？

ES2025 才有真正私有字段（#field），但很多老项目或需兼容旧环境时，WeakMap 是最稳妥的替代方案：外部无法访问，且实例销毁时数据自动清空。

把 WeakMap 实例定义在模块顶层（非 class 内），避免暴露
用 this 作为键，值存私有数据对象
所有方法通过闭包访问该 WeakMap，不暴露原始数据

const _privateData = new WeakMap();

class Person {
  constructor(name) {
    _privateData.set(this, { name, createdAt: Date.now() });
  }
  getName() {
    return _privateData.get(this)?.name;
  }
}

const p = new Person('Alice');
console.log(p.getName()); // 'Alice'
// p = null; → GC 后，_privateData 中对应项自动失效