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)

错误类型

TypeError

哪里出错了？

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