json-decycle

(es6) stringify and parse cycled reference json

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
json-decycle
1623.0.0a year ago9 years agoMinified + gzip package size for json-decycle in KB

Readme

json-decycle
Stringify and parse cycled reference json by replacing cycled references to JSON-reference

Is project alive?

Yes, it works just fine.
Because this library have no dependencies, it's not required to have frequent updates.
If You encounter a bug or need to support special case, feel free to file an issue or open PR.

Usage

import { decycle, retrocycle } from "json-decycle";

var cycled = {
  foo: {},
  bar: {},
};

cycled.foo.bar = cycled.foo;
cycled.bar.foo = cycled.bar;

var result = JSON.stringify(cycled, decycle());
// result === '{"foo":{"bar":{"foo":{"$ref":"#/foo"}}},"bar":{"$ref":"#/foo/bar"}}'

JSON.parse(result, retrocycle());
// => {foo: {{foo: [cyclic reference], bar: [cyclic reference]}}, bar: {{foo: [cyclic reference], bar: [cyclic reference]}}}

Extend JSON global object

JSON.parse and JSON.stringify is not modified
import { extend } from "json-decycle";

JSON.decycle({}) === "{}";
JSON.retrocycle("{}") === {};