JavaScriptJSON序列化_循环引用与自定义解析-js教程-PHP中文网

JavaScriptJSON序列化_循环引用与自定义解析

紅蓮之龍

发布： 2025-11-25 13:24:06

原创

782人浏览过

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

javascriptjson序列化_循环引用与自定义解析

在使用 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 手动追踪已访问的对象：

立即学习“Java免费学习笔记（深入）”；

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。

eMart 网店系统

功能列表：底层程序与前台页面分离的效果，对页面的修改无需改动任何程序代码。完善的标签系统，支持自定义标签，公用标签，快捷标签，动态标签，静态标签等等，支持标签内的vbs语法，原则上运用这些标签可以制作出任何想要的页面效果。兼容原来的栏目系统，可以很方便的插入一个栏目或者一个栏目组到页面的任何位置。底层模版解析程序具有非常高的效率，稳定性和容错性，即使模版中有错误的标签也不会影响页面的显示。所有的标

查看详情

以 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序列化_循环引用与自定义解析的详细内容，更多请关注php中文网其它相关文章！