JavaScriptJSON序列化：处理循环引用与自定义方法

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《JavaScript JSON序列化：循环引用处理与自定义解析》，聊聊，希望可以帮助到正在努力赚钱的你。

答案：使用 replacer 函数结合 WeakSet 可解决循环引用并自定义序列化逻辑，或引入 flatted 等库实现完整结构还原，同时利用 replacer 与 reviver 控制字段过滤与类型转换。

在使用 JavaScript 的 JSON.stringify() 方法进行对象序列化时，遇到循环引用会抛出错误。同时，在某些场景下，我们希望对序列化过程进行自定义控制，比如过滤字段或处理特殊类型。本文将说明如何解决循环引用问题，并实现自定义的 JSON 序列化与解析逻辑。

循环引用导致的问题

当一个对象的属性直接或间接引用自身时，就构成了循环引用。例如：

const obj = { name: "Alice" };
obj.self = obj;
JSON.stringify(obj); // 抛出 TypeError: Converting circular structure to JSON

浏览器和 Node.js 环境下的原生 JSON.stringify 无法处理这种结构，会立即中断并报错。

解决方案：使用 replacer 函数过滤引用

可以通过传入 replacer 函数来跳过特定属性。虽然不能直接检测所有循环引用，但可以结合 WeakSet 手动追踪已访问的对象：

function stringifySafe(obj) {
  const seen = new WeakSet();
  return JSON.stringify(obj, (key, value) => {
    if (typeof value === "object" && value !== null) {
      if (seen.has(value)) {
        return "[Circular]";
      }
      seen.add(value);
    }
    return value;
  });
}

这个方法能在序列化过程中识别重复引用，避免崩溃，同时用标记字符串代替循环部分，保留其余数据结构。

使用第三方库简化处理

对于复杂项目，推荐使用专门处理循环引用的库，如 flatted 或 cycle。

以 flatted 为例：

import { stringify, parse } from 'flatted';

const obj = { name: "Bob" };
obj.self = obj;

const str = stringify(obj); // 成功序列化
const recovered = parse(str); // 正确还原结构

这类库通过扁平化结构记录引用关系，能完整保存和恢复循环引用，适合需要精确还原的场景。

自定义序列化与反序列化逻辑

除了处理循环引用，有时还需控制哪些字段被序列化，或转换日期、函数等非标准类型。

replacer 和 reviver 参数提供了这样的能力：

• replacer：在序列化前筛选或转换值
• reviver：在反序列化后修正或重建值

const user = {
  name: "Charlie",
  password: "123456", // 敏感字段
  createdAt: new Date()
};

// 自定义序列化：隐藏密码，转换日期为时间戳
const json = JSON.stringify(user, (key, value) => {
  if (key === "password") return undefined;
  if (value instanceof Date) return value.getTime();
  return value;
});

// 反序列化时恢复日期对象
const parsed = JSON.parse(json, (key, value) => {
  if (key === "createdAt") return new Date(value);
  return value;
});

这样可以在传输中精简数据，同时保证关键信息正确重建。

基本上就这些。处理循环引用和自定义解析并不复杂，关键是理解 replacer 与 reviver 的执行时机，并根据需求选择手动控制或引入可靠工具库。

到这里，我们也就讲完了《JavaScriptJSON序列化：处理循环引用与自定义方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！