WeakSet 适合私有标记，因其仅存储对象的弱引用，不阻止垃圾回收，且无遍历接口、不可枚举、无需手动清理；它只表达“是否具有某状态”的布尔语义，避免内存泄漏和属性污染。

WeakSet 的作用是轻量标记对象，不干扰其生命周期。它不能存原始值，只接受对象；所有引用都是弱引用，对象一旦失去其他强引用，就会被自动回收，WeakSet 里的条目也随之消失。

为什么适合做私有数据标记

WeakSet 不暴露内部结构，没有 size、forEach、values() 等方法，外部无法遍历或清空它。配合闭包使用，能实现真正隔离的“标记”逻辑：

• 标记本身不可见、不可枚举，避免污染对象属性或被意外修改
• 无需手动清理——对象销毁时标记自动失效，杜绝内存泄漏
• 语义清晰：不是存数据，而是回答“这个对象是否具有某种状态”

典型私有标记用法示例

比如防止类实例重复初始化：

Expanso yaml-to-json

使用 Expanso Edge 管道将 YAML 输入转换为 JSON 格式。

下载

const initialized = new WeakSet();

class Logger {
  constructor() {
    if (initialized.has(this)) return;
    initialized.add(this);
    // 执行一次性初始化逻辑
    this._logBuffer = [];
  }
}

再比如标记 DOM 元素是否已绑定特定事件：

const boundElements = new WeakSet();

function bindOnce(element, handler) {
  if (!boundElements.has(element)) {
    element.addEventListener('click', handler);
    boundElements.add(element);
  }
}

注意事项

这些点容易踩坑，需特别留心：

• 传入非对象（如字符串、数字、null）会直接抛 TypeError
• 不能用于长期状态判断——has() 结果可能随 GC 发生变化
• 不要试图用 WeakSet 存私有数据本身（如配置、缓存值），它只适合布尔型标记；存数据请用 WeakMap
• 临时对象（如 {id: 1}）每次都是新实例，WeakSet 无法跨调用识别，不适合做去重依据