JSON.stringify序列化Set对象为空对象的解决方法

在JavaScript开发中，JSON.stringify是数据交换和调试的利器，但遇到Set对象时，它却会“静默罢工”——直接返回一个空对象{}。这并非它“识别”了Set，而是因为它根本处理不了Set的内部结构，最终只能交出一份无效的“白卷”。

为什么 Set 会变成 {}

问题的根源在于JSON.stringify的工作机制。它只能序列化标准的、可枚举的自有属性，并且只支持基本类型、数组和普通对象。而Set对象是由内置构造函数创建的，其核心数据被存储在引擎内部的、不可枚举的[[Entries]]槽中。

这就导致了一个尴尬的局面：当你尝试序列化一个Set时，JSON.stringify遍历了一圈，发现这个对象“空空如也”，没有任何它可以处理的属性。于是，它便返回了一个空对象的字符串表示。

console.log(JSON.stringify(new Set())); // "{}"
console.log(JSON.stringify(new Set([1, 2]))); // "{}"

无论Set是空的还是满载数据，输出结果都一样——一个孤零零的{}。

这个坑带来的实际问题

这种静默的转换会引发一系列隐蔽的bug：

• 误判数据状态：如果你习惯用JSON.stringify(obj) === '{}'来判断一个对象是否为空，那么一个刚初始化、正准备接收数据的Set就会被误判为空对象。
• 深拷贝彻底失效：想用JSON.parse(JSON.stringify(mySet))来快速深拷贝？得到的结果只会是一个普通的空对象{}，Set结构及其数据全部丢失。
• 调试时的困惑：在日志或控制台里看到一个{}，你很可能以为这是个普通的空对象，而不会意识到它原本是一个无法通过JSON还原的Set实例。

如何安全识别和处理 Set

要避开这个坑，关键在于使用正确的方法来识别和操作Set：

• 类型判断用instanceof：这是最可靠的方式。obj instanceof Set能明确告诉你对象的真实身份。
• 序列化前主动转换：如果需要将Set转化为JSON字符串，必须手动将其转为数组：JSON.stringify(Array.from(mySet))。
• 空值检查分情况：检查Set是否为空，应该使用mySet.size === 0。
• 封装统一工具函数：对于需要通用判断“逻辑空值”的场景，建议封装一个函数，根据类型分而治之：

  function isEmpty(value) {
    if (value instanceof Set || value instanceof Map) return value.size === 0;
    if (Array.isArray(value)) return value.length === 0;
    if (value && typeof value === 'object') return Object.keys(value).length === 0;
    // ... 其他类型处理
  }

延伸提醒：其他类似“隐身”类型

Set并非个例，JavaScript中一批“特殊对象”在JSON.stringify面前都有类似问题：

JSON.stringify(new Map()); // "{}"
JSON.stringify(new Date()); // 日期字符串（这是特例，有默认转换）
JSON.stringify(/abc/); // "{}"
JSON.stringify(BigInt(123)); // 直接报错：Uncaught TypeError

对于Map、正则表达式等类型，它们同样无法被正确序列化。而BigInt则更极端，直接会导致序列化过程抛出错误。因此，一个重要的原则是：永远不要依赖JSON.stringify的结果来做这些特殊类型的类型判断或空值校验。正确的类型检查和数据转换，永远是编码中需要手动把握的细节。