TypeError: cyclic object value

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

提示信息

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

错误类型

哪里出错了?

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

示例

循环引用

在如下循环结构中:

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

JSON.stringify() 将会报错

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

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

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

js
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.decycleJSON.retrocycle,这两个方法能够对循环对象引用结构进行编码和解码,并且使之成为一种扩展的且向下兼容的 JSON 格式。