json-serialize.js | |
|---|---|
| JSON-Serialize.js 1.1.3 2 | (c) 2011, 2012 Kevin Malakoff. 3 | JSON-Serialize is freely distributable under the MIT license. 4 | https://github.com/kmalakoff/json-serialize | (function() {
5 |
6 | this.JSON || (this.JSON = {}); // hopefully JSON is defined!
7 | JSON.SERIALIZE_VERSION = '1.1.3'; |
| //////////////HELPERS - BEGIN////////////////// | var isEmpty = function(obj) {
8 | for(var key in obj) { |
| a property, not a function | if (obj.hasOwnProperty(key)) return false;
9 | }
10 | return true;
11 | };
12 |
13 | var isArray = function(obj) {
14 | return obj.constructor == Array;
15 | };
16 |
17 | var stringHasISO8601DateSignature = function(string) {
18 | return (string.length>=19) && (string[4] == '-') && (string[7] == '-') && (string[10] == 'T') && (string[string.length-1] == 'Z');
19 | };
20 |
21 | var keyPath = function(object, keypath) {
22 | var keypath_components = keypath.split('.');
23 | if (keypath_components.length===1) return ((object instanceof Object) && (object.hasOwnProperty(keypath))) ? object[keypath] : void 0; // optimization
24 | var key, current_object = object;
25 | for (var i = 0, l = keypath_components.length; i < l;) {
26 | key = keypath_components[i];
27 | if (!(key in current_object)) break;
28 | if (++i === l) return current_object[key];
29 | current_object = current_object[key];
30 | if (!current_object || !(current_object instanceof Object)) break;
31 | }
32 | return void 0;
33 | }; |
| //////////////HELPERS - END////////////////// | |
| Convert an array of objects or an object to JSON using the convention that if an 34 | object has a toJSON function, it will use it rather than the raw object. | JSON.serialize = function(obj, options) { |
| Simple type - exit quickly | if (!obj || (typeof(obj)!=='object')) return obj; |
| use toJSON function - Note: Dates have a built in toJSON that converts them to ISO8601 UTC ("Z") strings | if(obj.toJSON) return obj.toJSON();
35 | else if (isEmpty(obj)) return null; |
| serialize an array | var result;
36 | if (isArray(obj)) {
37 | result = [];
38 | for (var i=0, l=obj.length; i<l;i++) { result.push(JSON.serialize(obj[i])); }
39 | return result;
40 | } |
| serialize the properties | else {
41 | result = {};
42 | for (var key in obj) { result[key] = JSON.serialize(obj[key]); }
43 | return result;
44 | }
45 | }; |
| Deserialized an array of JSON objects or each object individually using the following conventions:
46 | 1) if JSON has a recognized type identifier ('_type' as default), it will try to create an instance.
47 | 2) if the class refered to by the type identifier has a fromJSON function, it will try to create an instance.
48 | | JSON.deserialize = function(json, options) {
54 | var json_type = typeof(json); |
| special checks for strings | if (json_type==='string') { |
| The object is still a JSON string, convert to JSON | if (json.length && ((json[0] === '{') || (json[0] === '['))) {
55 | try { var json_as_JSON = JSON.parse(json); if (json_as_JSON) json = json_as_JSON; }
56 | catch (e) {throw new TypeError("Unable to parse JSON: " + json);}
57 | } |
| the object looks like a Date serialized to ISO8601 UTC ("Z") format, try automatically converting | else if (!(options && options.skip_dates) && stringHasISO8601DateSignature(json)) {
58 | try { var date = new Date(json); if (date) return date; }
59 | catch (e) {}
60 | }
61 | } |
| Simple type - exit quickly | if ((json_type!=='object') || isEmpty(json)) return json; |
| Parse an array | var result;
62 | if (isArray(json)) {
63 | result = [];
64 | for (var i=0, l=json.length; i<l;i++) { result.push(JSON.deserialize(json[i])); }
65 | return result;
66 | } |
| Parse the properties individually | else if ((options && options.skip_type_field) || !json.hasOwnProperty(JSON.deserialize.TYPE_FIELD)) {
67 | result = {};
68 | for (var key in json) { result[key] = JSON.deserialize(json[key]); }
69 | return result;
70 | } |
| Find and use the fromJSON function | else
71 | {
72 | var type = json[JSON.deserialize.TYPE_FIELD];
73 | var root, constructor_or_root, instance; |
| Try searching in the available namespaces | for (var j=0, k=JSON.deserialize.NAMESPACE_ROOTS.length; j<k;j++) {
74 | root = JSON.deserialize.NAMESPACE_ROOTS[j];
75 | constructor_or_root = keyPath(root, type);
76 | if (!constructor_or_root) continue; |
| class/root parse function | if (constructor_or_root.fromJSON) return constructor_or_root.fromJSON(json); |
| instance parse function (Backbone.Model and Backbone.Collection style) | else if (constructor_or_root.prototype && constructor_or_root.prototype.parse) {
77 | instance = new constructor_or_root();
78 | if (instance.set) return instance.set(instance.parse(json));
79 | else return instance.parse(json);
80 | }
81 | }
82 |
83 | return null;
84 | }
85 | };
86 |
87 | JSON.deserialize.TYPE_FIELD = '_type';
88 | JSON.deserialize.NAMESPACE_ROOTS = [this];
89 | })();
90 |
91 | |
| Source: | " + escapeText( source ) + " |
|---|
| Expected: | " + expected + " |
|---|---|
| Result: | " + actual + " |
| Diff: | " + QUnit.diff( expected, actual ) + " |
| Source: | " + escapeText( source ) + " |
| Result: | " + escapeText( actual ) + " |
|---|---|
| Source: | " + escapeText( source ) + " |