大网数据广告活动
Web 标准与前端开发

TypeError: cyclic object value

· 52CE 我爱测

在JSON中出现循环引用时,JavaScript 会抛出 "cyclic object value" 的异常。JSON.stringify()并不会尝试解决这个问题,因此导致运行失败。

在JSON中出现循环引用时,JavaScript 会抛出 "cyclic object value" 的异常。JSON.stringify()并不会尝试解决这个问题,因此导致运行失败。

提示信息

TypeError: cyclic object value (Firefox)
TypeError: Converting circular structure to JSON (Chrome and Opera)
TypeError: Circular reference in value argument not supported (Edge)

错误类型

TypeError

哪里出错了?

JSON 格式本身不支持循环引用对象(尽管存在IETF 草案),因此 JSON.stringify() 并不会尝试解决这个问题而是直接运行失败。

示例

循环引用

在如下循环结构中:

var circularReference = { otherData: 123 };
circularReference.myself = circularReference;

JSON.stringify() 将会报错

JSON.stringify(circularReference);
// TypeError: cyclic object value

要处理循环引用的 JSON,可以使用支持这种结构的库 (例如cycle.js)),或者自己实现,需要通过可序列化值查找、替换或者移除循环引用。

下面的代码片段演示了如何使用JSON.stringify()的 replacer 参数查找和过滤(会导致数据丢失)循环引用。

const getCircularReplacer = () => {
  const seen = new WeakSet();
  return (key, value) => {
    if (typeof value === "object" && value !== null) {
      if (seen.has(value)) {
        return;
      }
      seen.add(value);
    }
    return value;
  };
};

JSON.stringify(circularReference, getCircularReplacer());
// {"otherData":123}

参见

  • JSON.stringify
  • cycle.js – 介绍两个方法,JSON.decycle 和 JSON.retrocycle,这两个方法能够对循环对象引用结构进行编码和解码,并且使之成为一种扩展的且向下兼容的 JSON 格式。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。