Skip to content

Instantly share code, notes, and snippets.

@deanrather
Created July 28, 2015 09:45
Show Gist options
  • Star 2 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save deanrather/0bcb1d14aa32136878e3 to your computer and use it in GitHub Desktop.
Save deanrather/0bcb1d14aa32136878e3 to your computer and use it in GitHub Desktop.
JSON-encoding / decoding objects with circular references
/*
cycle.js
2015-02-25
Public Domain.
NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
This code should be minified before deployment.
See http://javascript.crockford.com/jsmin.html
USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
NOT CONTROL.
*/
/*jslint eval, for */
/*property
$ref, apply, call, decycle, hasOwnProperty, length, prototype, push,
retrocycle, stringify, test, toString
*/
if (typeof JSON.decycle !== 'function') {
JSON.decycle = function decycle(object) {
'use strict';
// Make a deep copy of an object or array, assuring that there is at most
// one instance of each object or array in the resulting structure. The
// duplicate references (which might be forming cycles) are replaced with
// an object of the form
// {$ref: PATH}
// where the PATH is a JSONPath string that locates the first occurance.
// So,
// var a = [];
// a[0] = a;
// return JSON.stringify(JSON.decycle(a));
// produces the string '[{"$ref":"$"}]'.
// JSONPath is used to locate the unique object. $ indicates the top level of
// the object or array. [NUMBER] or [STRING] indicates a child member or
// property.
var objects = [], // Keep a reference to each unique object or array
paths = []; // Keep the path to each unique object or array
return (function derez(value, path) {
// The derez recurses through the object, producing the deep copy.
var i, // The loop counter
name, // Property name
nu; // The new object or array
// typeof null === 'object', so go on if this value is really an object but not
// one of the weird builtin objects.
if (typeof value === 'object' && value !== null &&
!(value instanceof Boolean) &&
!(value instanceof Date) &&
!(value instanceof Number) &&
!(value instanceof RegExp) &&
!(value instanceof String)) {
// If the value is an object or array, look to see if we have already
// encountered it. If so, return a $ref/path object. This is a hard way,
// linear search that will get slower as the number of unique objects grows.
for (i = 0; i < objects.length; i += 1) {
if (objects[i] === value) {
return {$ref: paths[i]};
}
}
// Otherwise, accumulate the unique value and its path.
objects.push(value);
paths.push(path);
// If it is an array, replicate the array.
if (Object.prototype.toString.apply(value) === '[object Array]') {
nu = [];
for (i = 0; i < value.length; i += 1) {
nu[i] = derez(value[i], path + '[' + i + ']');
}
} else {
// If it is an object, replicate the object.
nu = {};
for (name in value) {
if (Object.prototype.hasOwnProperty.call(value, name)) {
nu[name] = derez(value[name],
path + '[' + JSON.stringify(name) + ']');
}
}
}
return nu;
}
return value;
}(object, '$'));
};
}
if (typeof JSON.retrocycle !== 'function') {
JSON.retrocycle = function retrocycle($) {
'use strict';
// Restore an object that was reduced by decycle. Members whose values are
// objects of the form
// {$ref: PATH}
// are replaced with references to the value found by the PATH. This will
// restore cycles. The object will be mutated.
// The eval function is used to locate the values described by a PATH. The
// root object is kept in a $ variable. A regular expression is used to
// assure that the PATH is extremely well formed. The regexp contains nested
// * quantifiers. That has been known to have extremely bad performance
// problems on some browsers for very long strings. A PATH is expected to be
// reasonably short. A PATH is allowed to belong to a very restricted subset of
// Goessner's JSONPath.
// So,
// var s = '[{"$ref":"$"}]';
// return JSON.retrocycle(JSON.parse(s));
// produces an array containing a single element which is the array itself.
var px = /^\$(?:\[(?:\d+|\"(?:[^\\\"\u0000-\u001f]|\\([\\\"\/bfnrt]|u[0-9a-zA-Z]{4}))*\")\])*$/;
(function rez(value) {
// The rez function walks recursively through the object looking for $ref
// properties. When it finds one that has a value that is a path, then it
// replaces the $ref object with a reference to the value that is found by
// the path.
var i, item, name, path;
if (value && typeof value === 'object') {
if (Object.prototype.toString.apply(value) === '[object Array]') {
for (i = 0; i < value.length; i += 1) {
item = value[i];
if (item && typeof item === 'object') {
path = item.$ref;
if (typeof path === 'string' && px.test(path)) {
value[i] = eval(path);
} else {
rez(item);
}
}
}
} else {
for (name in value) {
if (typeof value[name] === 'object') {
item = value[name];
if (item) {
path = item.$ref;
if (typeof path === 'string' && px.test(path)) {
value[name] = eval(path);
} else {
rez(item);
}
}
}
}
}
}
}($));
return $;
};
}
/**
* Copyright (c) 2009-2012 Ivo Wetzel.
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
(function(Array, undefined) {
"use strict";
// Some lookup tables
var chrTable = new Array(256),
maskTable = new Array(9),
powTable = new Array(9),
reversePowTable = new Array(9);
for(var i = 0; i < 256; i++) {
chrTable[i] = String.fromCharCode(i);
}
for(var f = 0; f < 9; f++) {
maskTable[f] = ~((powTable[f] = Math.pow(2, f) - 1) ^ 0xFF);
reversePowTable[f] = Math.pow(10, f);
}
var bitStream = '',
bitValue = 0,
bitsLeft = 8,
streamIndex = 0;
function write(val, count) {
var overflow = count - bitsLeft,
use = bitsLeft < count ? bitsLeft : count,
shift = bitsLeft - use;
if (overflow > 0) {
bitValue += val >> overflow << shift;
} else {
bitValue += val << shift;
}
bitsLeft -= use;
if (bitsLeft === 0) {
bitStream += chrTable[bitValue];
bitsLeft = 8;
bitValue = 0;
if (overflow > 0) {
bitValue += (val & powTable[overflow]) << (8 - overflow);
bitsLeft -= overflow;
}
}
}
function read(count) {
var overflow = count - bitsLeft,
use = bitsLeft < count ? bitsLeft : count,
shift = bitsLeft - use;
// Wrap bits over to next byte
var val = (bitValue & maskTable[bitsLeft]) >> shift;
bitsLeft -= use;
if (bitsLeft === 0) {
bitValue = bitStream.charCodeAt(++streamIndex);
bitsLeft = 8;
if (overflow > 0) {
val = val << overflow | ((bitValue & maskTable[bitsLeft]) >> 8 - overflow);
bitsLeft -= overflow;
}
}
if (streamIndex > bitStream.length) {
return 7;
}
return val;
}
// Encoder ----------------------------------------------------------------
function _encode(value, top) {
// Numbers
if (typeof value === 'number') {
var type = value !== (value | 0) ? 1 : 0,
sign = 0;
if (value < 0) {
value = -value;
sign = 1;
}
write(1 + type, 3);
// Float
if (type) {
var shift = 0,
step = 10,
m = value,
tmp = 0;
// Figure out the exponent
do {
m = value * step;
step *= 10;
shift++;
tmp = m | 0;
} while(m - tmp > 1 / step && shift < 8 && m < 214748364);
// Correct if we overshoot
step = tmp / 10;
if (step === (step | 0)) {
tmp = step;
shift--;
}
value = tmp;
}
// 2 size 0-3: 0 = < 16 1 = < 256 2 = < 65536 3 >=
if (value < 2) {
write(value, 4);
} else if (value < 16) {
write(1, 3);
write(value, 4);
} else if (value < 256) {
write(2, 3);
write(value, 8);
} else if (value < 4096) {
write(3, 3);
write(value >> 8 & 0xff, 4);
write(value & 0xff, 8);
} else if (value < 65536) {
write(4, 3);
write(value >> 8 & 0xff, 8);
write(value & 0xff, 8);
} else if (value < 1048576) {
write(5, 3);
write(value >> 16 & 0xff, 4);
write(value >> 8 & 0xff, 8);
write(value & 0xff, 8);
} else if (value < 16777216) {
write(6, 3);
write(value >> 16 & 0xff, 8);
write(value >> 8 & 0xff, 8);
write(value & 0xff, 8);
} else {
write(7, 3);
write(value >> 24 & 0xff, 8);
write(value >> 16 & 0xff, 8);
write(value >> 8 & 0xff, 8);
write(value & 0xff, 8);
}
write(sign, 1);
if (type) {
write(shift, 4);
}
// Strings
} else if (typeof value === 'string') {
var len = value.length;
write(3, 3);
if (len > 65535) {
write(31, 5);
write(len >> 24 & 0xff, 8);
write(len >> 16 & 0xff, 8);
write(len >> 8 & 0xff, 8);
write(len & 0xff, 8);
} else if (len > 255) {
write(30, 5);
write(len >> 8 & 0xff, 8);
write(len & 0xff, 8);
} else if (len > 28) {
write(29, 5);
write(len, 8);
} else {
write(len, 5);
}
// Write a raw string to the stream
if (bitsLeft !== 8) {
bitStream += chrTable[bitValue];
bitValue = 0;
bitsLeft = 8;
}
bitStream += value;
// Booleans
} else if (typeof value === 'boolean') {
write(+value, 4);
// Null
} else if (value === null) {
write(7, 3);
write(0, 1);
// Arrays
} else if (value instanceof Array) {
write(4, 3);
for(var i = 0, l = value.length; i < l; i++) {
_encode(value[i]);
}
if (!top) {
write(6, 3);
}
// Object
} else {
write(5, 3);
for(var e in value) {
_encode(e);
_encode(value[e]);
}
if (!top) {
write(6, 3);
}
}
}
function encode(value) {
bitsLeft = 8;
bitValue = 0;
bitStream = '';
_encode(value, true);
write(7, 3);
write(1, 1);
if (bitValue > 0) {
bitStream += chrTable[bitValue];
}
return bitStream;
}
// Decoder ----------------------------------------------------------------
function decode(string) {
var stack = [], i = -1, decoded,
type, top, value,
getKey = false, key, isObj;
bitsLeft = 8;
streamIndex = 0;
bitStream = string;
bitValue = bitStream.charCodeAt(streamIndex);
while(true) {
// Grab type
type = read(3);
switch(type) {
// Bool
case 0:
value = read(1) ? true : false;
break;
// EOS / Stream Overrun / Null
case 7:
switch(read(1)) {
case 1:
return decoded;
case 7:
return undefined;
default:
value = null;
}
break;
// Integer / Float
case 1:
case 2:
switch(read(3)) {
case 0:
value = read(1);
break;
case 1:
value = read(4);
break;
case 2:
value = read(8);
break;
case 3:
value = (read(4) << 8)
+ read(8);
break;
case 4:
value = (read(8) << 8)
+ read(8);
break;
case 5:
value = (read(4) << 16)
+ (read(8) << 8)
+ read(8);
break;
case 6:
value = (read(8) << 16)
+ (read(8) << 8)
+ read(8);
break;
case 7:
value = (read(8) << 24)
+ (read(8) << 16)
+ (read(8) << 8)
+ read(8);
break;
}
if (read(1)) {
value = -value;
}
if (type === 2) {
value /= reversePowTable[read(4)];
}
break;
// String
case 3:
var size = read(5);
switch(size) {
case 31:
size = (read(8) << 24)
+ (read(8) << 16)
+ (read(8) << 8)
+ read(8);
break;
case 30:
size = (read(8) << 8)
+ read(8);
break;
case 29:
size = read(8);
break;
}
// Read a raw string from the stream
if (bitsLeft !== 8) {
streamIndex++;
bitValue = 0;
bitsLeft = 8;
}
value = bitStream.substr(streamIndex, size);
streamIndex += size;
bitValue = bitStream.charCodeAt(streamIndex);
if (getKey) {
key = value;
getKey = false;
continue;
}
break;
// Open Array / Objects
case 4:
case 5:
getKey = type === 5;
value = getKey ? {} : [];
if (decoded === undefined) {
decoded = value;
} else {
if (isObj) {
top[key] = value;
} else {
top.push(value);
}
}
top = stack[++i] = value;
isObj = !(top instanceof Array);
continue;
// Close Array / Object
case 6:
top = stack[--i];
getKey = isObj = !(top instanceof Array);
continue;
}
// Assign value to top of stack or return value
if (isObj) {
top[key] = value;
getKey = true;
} else if (top !== undefined) {
top.push(value);
} else {
return value;
}
}
}
// Exports
if (typeof exports !== 'undefined') {
exports.encode = encode;
exports.decode = decode;
} else {
window.BISON = {
encode: encode,
decode: decode
};
}
})(Array);
o = {
myBool: false,
myInt: 1,
myString: "Fun String",
myObject: {
a: 1,
b: 2,
c: 3,
id: 'lloyd'
},
myArray: [
'apple',
'banana',
'cat'
],
id: 'dean',
myObject2: {'id': 'lloyd'}
};
o.myRecursion = o;
o.myFunction = console.log;
o.myObject2ref = o.myObject2;
console.log('original', o);
o = JSON.decycle(o);
console.log('decycled', o);
o = JSON.stringify(o);
console.log('stringified', o);
o = BISON.encode(o);
console.log('bisond', o);
o = BISON.decode(o);
console.log('unbisond', o);
o = JSON.parse(o);
console.log('unstringified', o);
o = JSON.retrocycle(o);
console.log('retrodecycled', o);
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment