Stringify.js revision 055efb6373eaf6d68041128d6a259f50b3b02ba9
2ronwalf/**
2ronwalf * Provides Y.JSON.stringify method for converting objects to JSON strings.
2ronwalf * @module JSON
22daenzerorama * @class JSON
2ronwalf * @static
2ronwalf */
2ronwalfvar isA = Y.Lang.isArray;
2ronwalf
2ronwalfY.JSON = Y.JSON || {};
2ronwalf
2ronwalfY.mix(Y.JSON,{
2ronwalf /**
2ronwalf * Regex used to replace special characters in strings for JSON
2ronwalf * stringification.
2ronwalf * @property _SPECIAL_CHARS
2ronwalf * @type {RegExp}
2ronwalf * @static
2ronwalf * @private
2ronwalf */
10daenzerorama _SPECIAL_CHARS : /["\\\x00-\x1f\x7f-\x9f]/g,
10daenzerorama
2ronwalf /**
2ronwalf * Character substitution map for common escapes and special characters.
2ronwalf * @property _CHARS
2ronwalf * @type {Object}
2ronwalf * @static
2ronwalf * @private
2ronwalf */
2ronwalf _CHARS : {
2ronwalf '\b': '\\b',
2ronwalf '\t': '\\t',
2ronwalf '\n': '\\n',
2ronwalf '\f': '\\f',
2ronwalf '\r': '\\r',
2ronwalf '"' : '\\"',
2ronwalf '\\': '\\\\'
2ronwalf },
2ronwalf
2ronwalf /**
2ronwalf * Serializes a Date instance as a UTC date string. Used internally by
2ronwalf * stringify. Override this method if you need Dates serialized in a
2ronwalf * different format.
2ronwalf * @method dateToString
2ronwalf * @param d {Date} The Date to serialize
2ronwalf * @return {String} stringified Date in UTC format YYYY-MM-DDTHH:mm:SSZ
2ronwalf * @static
10daenzerorama */
10daenzerorama dateToString : function (d) {
10daenzerorama function _zeroPad(v) {
10daenzerorama return v < 10 ? '0' + v : v;
10daenzerorama }
10daenzerorama
10daenzerorama return '"' + d.getUTCFullYear() + '-' +
10daenzerorama _zeroPad(d.getUTCMonth() + 1) + '-' +
10daenzerorama _zeroPad(d.getUTCDate()) + 'T' +
10daenzerorama _zeroPad(d.getUTCHours()) + ':' +
10daenzerorama _zeroPad(d.getUTCMinutes()) + ':' +
10daenzerorama _zeroPad(d.getUTCSeconds()) + 'Z"';
10daenzerorama },
10daenzerorama
10daenzerorama /**
10daenzerorama * Converts an arbitrary value to a JSON string representation.
10daenzerorama * Cyclical object or array references are replaced with null.
10daenzerorama * If a whitelist is provided, only matching object keys will be included.
10daenzerorama * If a depth limit is provided, objects and arrays at that depth will
10daenzerorama * be stringified as empty.
10daenzerorama * @method stringify
10daenzerorama * @param o {MIXED} any arbitrary object to convert to JSON string
10daenzerorama * @param w {Array} (optional) whitelist of acceptable object keys to include
10daenzerorama * @param d {number} (optional) depth limit to recurse objects/arrays (practical minimum 1)
10daenzerorama * @return {string} JSON string representation of the input
10daenzerorama * @static
10daenzerorama * @public
10daenzerorama */
10daenzerorama stringify : function (o,w,d) {
10daenzerorama
10daenzerorama var m = Y.JSON._CHARS,
2ronwalf str_re = Y.JSON._SPECIAL_CHARS,
rep = typeof w === 'function' ? w : null,
pstack = []; // Processing stack used for cyclical ref protection
if (rep || typeof w !== 'object') {
w = undefined;
}
// escape encode special characters
var _char = function (c) {
if (!m[c]) {
var a = c.charCodeAt();
m[c] = '\\u00' + Math.floor(a / 16).toString(16) +
(a % 16).toString(16);
}
return m[c];
};
// Enclose the escaped string in double quotes
var _string = function (s) {
return '"' + s.replace(str_re, _char) + '"';
};
// Use the configured date conversion
var _date = Y.JSON.dateToString;
// Worker function. Fork behavior on data type and recurse objects and
// arrays per the configured depth.
var _stringify = function (h,key,d) {
var o = typeof rep === 'function' ? rep.call(h,key,h[key]) : h[key],
t = typeof o,
i,len,j, // array iteration
k,v, // object iteration
a; // composition array for performance over string concat
// String
if (t === 'string') {
return _string(o);
}
// native boolean and Boolean instance
if (t === 'boolean' || o instanceof Boolean) {
return String(o);
}
// native number and Number instance
if (t === 'number' || o instanceof Number) {
return isFinite(o) ? String(o) : 'null';
}
// Date
if (o instanceof Date) {
return _date(o);
}
// Object types
if (t === 'object') {
if (!o) {
return 'null';
}
// Check for cyclical references
for (i = pstack.length - 1; i >= 0; --i) {
if (pstack[i] === o) {
return 'null';
}
}
// Add the object to the processing stack
pstack[pstack.length] = o;
a = [];
// Only recurse if we're above depth config
if (d > 0) {
// Array
if (isA(o)) {
for (i = o.length - 1; i >= 0; --i) {
a[i] = _stringify(o,i,d-1) || 'null';
}
// Object
} else {
// If whitelist provided, take only those keys
k = isA(w) ? w : Y.Object.keys(w||o);
for (i = 0, j = 0, len = k.length; i < len; ++i) {
if (typeof k[i] === 'string') {
v = _stringify(o,k[i],d-1);
if (v) {
a[j++] = _string(k[i]) + ':' + v;
}
}
}
}
}
// remove the array from the stack
pstack.pop();
return isA(o) ? '['+a.join(',')+']' : '{'+a.join(',')+'}';
}
return undefined; // invalid input
};
// Default depth to POSITIVE_INFINITY
d = d >= 0 ? d : 1/0;
// process the input
return _stringify({'':o},'',d);
}
});