OLD | NEW |
(Empty) | |
| 1 // Copyright 2014 the V8 project authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. |
| 4 |
| 5 /* |
| 6 http://www.JSON.org/json2.js |
| 7 2009-04-16 |
| 8 |
| 9 Public Domain. |
| 10 |
| 11 NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK. |
| 12 |
| 13 See http://www.JSON.org/js.html |
| 14 |
| 15 This file creates a global JSON object containing two methods: stringify |
| 16 and parse. |
| 17 |
| 18 JSON.stringify(value, replacer, space) |
| 19 value any JavaScript value, usually an object or array. |
| 20 |
| 21 replacer an optional parameter that determines how object |
| 22 values are stringified for objects. It can be a |
| 23 function or an array of strings. |
| 24 |
| 25 space an optional parameter that specifies the indentation |
| 26 of nested structures. If it is omitted, the text will |
| 27 be packed without extra whitespace. If it is a number, |
| 28 it will specify the number of spaces to indent at each |
| 29 level. If it is a string (such as '\t' or ' '), |
| 30 it contains the characters used to indent at each level. |
| 31 |
| 32 This method produces a JSON text from a JavaScript value. |
| 33 |
| 34 When an object value is found, if the object contains a toJSON |
| 35 method, its toJSON method will be called and the result will be |
| 36 stringified. A toJSON method does not serialize: it returns the |
| 37 value represented by the name/value pair that should be serialized, |
| 38 or undefined if nothing should be serialized. The toJSON method |
| 39 will be passed the key associated with the value, and this will be |
| 40 bound to the object holding the key. |
| 41 |
| 42 For example, this would serialize Dates as ISO strings. |
| 43 |
| 44 Date.prototype.toJSON = function (key) { |
| 45 function f(n) { |
| 46 // Format integers to have at least two digits. |
| 47 return n < 10 ? '0' + n : n; |
| 48 } |
| 49 |
| 50 return this.getUTCFullYear() + '-' + |
| 51 f(this.getUTCMonth() + 1) + '-' + |
| 52 f(this.getUTCDate()) + 'T' + |
| 53 f(this.getUTCHours()) + ':' + |
| 54 f(this.getUTCMinutes()) + ':' + |
| 55 f(this.getUTCSeconds()) + 'Z'; |
| 56 }; |
| 57 |
| 58 You can provide an optional replacer method. It will be passed the |
| 59 key and value of each member, with this bound to the containing |
| 60 object. The value that is returned from your method will be |
| 61 serialized. If your method returns undefined, then the member will |
| 62 be excluded from the serialization. |
| 63 |
| 64 If the replacer parameter is an array of strings, then it will be |
| 65 used to select the members to be serialized. It filters the results |
| 66 such that only members with keys listed in the replacer array are |
| 67 stringified. |
| 68 |
| 69 Values that do not have JSON representations, such as undefined or |
| 70 functions, will not be serialized. Such values in objects will be |
| 71 dropped; in arrays they will be replaced with null. You can use |
| 72 a replacer function to replace those with JSON values. |
| 73 JSON.stringify(undefined) returns undefined. |
| 74 |
| 75 The optional space parameter produces a stringification of the |
| 76 value that is filled with line breaks and indentation to make it |
| 77 easier to read. |
| 78 |
| 79 If the space parameter is a non-empty string, then that string will |
| 80 be used for indentation. If the space parameter is a number, then |
| 81 the indentation will be that many spaces. |
| 82 |
| 83 Example: |
| 84 |
| 85 text = JSON.stringify(['e', {pluribus: 'unum'}]); |
| 86 // text is '["e",{"pluribus":"unum"}]' |
| 87 |
| 88 |
| 89 text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t'); |
| 90 // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]' |
| 91 |
| 92 text = JSON.stringify([new Date()], function (key, value) { |
| 93 return this[key] instanceof Date ? |
| 94 'Date(' + this[key] + ')' : value; |
| 95 }); |
| 96 // text is '["Date(---current time---)"]' |
| 97 |
| 98 |
| 99 JSON.parse(text, reviver) |
| 100 This method parses a JSON text to produce an object or array. |
| 101 It can throw a SyntaxError exception. |
| 102 |
| 103 The optional reviver parameter is a function that can filter and |
| 104 transform the results. It receives each of the keys and values, |
| 105 and its return value is used instead of the original value. |
| 106 If it returns what it received, then the structure is not modified. |
| 107 If it returns undefined then the member is deleted. |
| 108 |
| 109 Example: |
| 110 |
| 111 // Parse the text. Values that look like ISO date strings will |
| 112 // be converted to Date objects. |
| 113 |
| 114 myData = JSON.parse(text, function (key, value) { |
| 115 var a; |
| 116 if (typeof value === 'string') { |
| 117 a = |
| 118 /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value); |
| 119 if (a) { |
| 120 return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4], |
| 121 +a[5], +a[6])); |
| 122 } |
| 123 } |
| 124 return value; |
| 125 }); |
| 126 |
| 127 myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) { |
| 128 var d; |
| 129 if (typeof value === 'string' && |
| 130 value.slice(0, 5) === 'Date(' && |
| 131 value.slice(-1) === ')') { |
| 132 d = new Date(value.slice(5, -1)); |
| 133 if (d) { |
| 134 return d; |
| 135 } |
| 136 } |
| 137 return value; |
| 138 }); |
| 139 |
| 140 |
| 141 This is a reference implementation. You are free to copy, modify, or |
| 142 redistribute. |
| 143 |
| 144 This code should be minified before deployment. |
| 145 See http://javascript.crockford.com/jsmin.html |
| 146 |
| 147 USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO |
| 148 NOT CONTROL. |
| 149 */ |
| 150 |
| 151 /*jslint evil: true */ |
| 152 |
| 153 /*global JSON */ |
| 154 |
| 155 /*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply, |
| 156 call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours, |
| 157 getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join, |
| 158 lastIndex, length, parse, prototype, push, replace, slice, stringify, |
| 159 test, toJSON, toString, valueOf |
| 160 */ |
| 161 |
| 162 // Create a JSON object only if one does not already exist. We create the |
| 163 // methods in a closure to avoid creating global variables. |
| 164 |
| 165 if (!this.JSON) { |
| 166 JSON = {}; |
| 167 } |
| 168 (function () { |
| 169 |
| 170 function f(n) { |
| 171 // Format integers to have at least two digits. |
| 172 return n < 10 ? '0' + n : n; |
| 173 } |
| 174 |
| 175 if (typeof Date.prototype.toJSON !== 'function') { |
| 176 |
| 177 Date.prototype.toJSON = function (key) { |
| 178 |
| 179 return this.getUTCFullYear() + '-' + |
| 180 f(this.getUTCMonth() + 1) + '-' + |
| 181 f(this.getUTCDate()) + 'T' + |
| 182 f(this.getUTCHours()) + ':' + |
| 183 f(this.getUTCMinutes()) + ':' + |
| 184 f(this.getUTCSeconds()) + 'Z'; |
| 185 }; |
| 186 } |
| 187 |
| 188 var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u
202f\u2060-\u206f\ufeff\ufff0-\uffff]/g, |
| 189 escapable = /[\\\"\x00-\x1f]/g, |
| 190 gap, |
| 191 indent, |
| 192 meta = { // table of character substitutions |
| 193 '\b': '\\b', |
| 194 '\t': '\\t', |
| 195 '\n': '\\n', |
| 196 '\f': '\\f', |
| 197 '\r': '\\r', |
| 198 '"' : '\\"', |
| 199 '\\': '\\\\' |
| 200 }, |
| 201 rep; |
| 202 |
| 203 |
| 204 function quote(string) { |
| 205 |
| 206 // If the string contains no control characters, no quote characters, and no |
| 207 // backslash characters, then we can safely slap some quotes around it. |
| 208 // Otherwise we must also replace the offending characters with safe escape |
| 209 // sequences. |
| 210 |
| 211 escapable.lastIndex = 0; |
| 212 return escapable.test(string) ? |
| 213 '"' + string.replace(escapable, function (a) { |
| 214 var c = meta[a]; |
| 215 return typeof c === 'string' ? c : |
| 216 '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4); |
| 217 }) + '"' : |
| 218 '"' + string + '"'; |
| 219 } |
| 220 |
| 221 |
| 222 function str(key, holder) { |
| 223 |
| 224 // Produce a string from holder[key]. |
| 225 |
| 226 var i, // The loop counter. |
| 227 k, // The member key. |
| 228 v, // The member value. |
| 229 length, |
| 230 mind = gap, |
| 231 partial, |
| 232 value = holder[key]; |
| 233 |
| 234 // If the value has a toJSON method, call it to obtain a replacement value. |
| 235 |
| 236 if (value && typeof value === 'object' && |
| 237 typeof value.toJSON === 'function') { |
| 238 value = value.toJSON(key); |
| 239 } |
| 240 |
| 241 // If we were called with a replacer function, then call the replacer to |
| 242 // obtain a replacement value. |
| 243 |
| 244 if (typeof rep === 'function') { |
| 245 value = rep.call(holder, key, value); |
| 246 } |
| 247 |
| 248 // What happens next depends on the value's type. |
| 249 |
| 250 if (value && ((typeof value) === "object")) { |
| 251 if (value.constructor === String || value.constructor === Number ||
value.constructor === Boolean) |
| 252 value = value.valueOf(); |
| 253 } |
| 254 |
| 255 switch (typeof value) { |
| 256 case 'string': |
| 257 return quote(value); |
| 258 |
| 259 case 'number': |
| 260 |
| 261 // JSON numbers must be finite. Encode non-finite numbers as null. |
| 262 |
| 263 return isFinite(value) ? String(value) : 'null'; |
| 264 |
| 265 case 'boolean': |
| 266 case 'null': |
| 267 |
| 268 // If the value is a boolean or null, convert it to a string. Note: |
| 269 // typeof null does not produce 'null'. The case is included here in |
| 270 // the remote chance that this gets fixed someday. |
| 271 |
| 272 return String(value); |
| 273 |
| 274 // If the type is 'object', we might be dealing with an object or an array or |
| 275 // null. |
| 276 |
| 277 case 'object': |
| 278 |
| 279 // Due to a specification blunder in ECMAScript, typeof null is 'object', |
| 280 // so watch out for that case. |
| 281 |
| 282 if (!value) { |
| 283 return 'null'; |
| 284 } |
| 285 |
| 286 // Make an array to hold the partial results of stringifying this object value. |
| 287 |
| 288 gap += indent; |
| 289 partial = []; |
| 290 |
| 291 // Is the value an array? |
| 292 |
| 293 if (Object.prototype.toString.apply(value) === '[object Array]') { |
| 294 |
| 295 // The value is an array. Stringify every element. Use null as a placeholder |
| 296 // for non-JSON values. |
| 297 |
| 298 length = value.length; |
| 299 for (i = 0; i < length; i += 1) { |
| 300 partial[i] = str(i, value) || 'null'; |
| 301 } |
| 302 |
| 303 // Join all of the elements together, separated with commas, and wrap them in |
| 304 // brackets. |
| 305 |
| 306 v = partial.length === 0 ? '[]' : |
| 307 gap ? '[\n' + gap + |
| 308 partial.join(',\n' + gap) + '\n' + |
| 309 mind + ']' : |
| 310 '[' + partial.join(',') + ']'; |
| 311 gap = mind; |
| 312 return v; |
| 313 } |
| 314 |
| 315 // If the replacer is an array, use it to select the members to be stringified. |
| 316 |
| 317 if (rep && typeof rep === 'object') { |
| 318 length = rep.length; |
| 319 for (i = 0; i < length; i += 1) { |
| 320 k = rep[i]; |
| 321 if (typeof k === 'string') { |
| 322 v = str(k, value); |
| 323 if (v) { |
| 324 partial.push(quote(k) + (gap ? ': ' : ':') + v); |
| 325 } |
| 326 } |
| 327 } |
| 328 } else { |
| 329 |
| 330 // Otherwise, iterate through all of the keys in the object. |
| 331 |
| 332 for (k in value) { |
| 333 if (Object.hasOwnProperty.call(value, k)) { |
| 334 v = str(k, value); |
| 335 if (v) { |
| 336 partial.push(quote(k) + (gap ? ': ' : ':') + v); |
| 337 } |
| 338 } |
| 339 } |
| 340 } |
| 341 |
| 342 // Join all of the member texts together, separated with commas, |
| 343 // and wrap them in braces. |
| 344 |
| 345 v = partial.length === 0 ? '{}' : |
| 346 gap ? '{\n' + gap + partial.join(',\n' + gap) + '\n' + |
| 347 mind + '}' : '{' + partial.join(',') + '}'; |
| 348 gap = mind; |
| 349 return v; |
| 350 } |
| 351 } |
| 352 |
| 353 // If the JSON object does not yet have a stringify method, give it one. |
| 354 |
| 355 if (typeof JSON.stringify !== 'function') { |
| 356 JSON.stringify = function (value, replacer, space) { |
| 357 |
| 358 // The stringify method takes a value and an optional replacer, and an optional |
| 359 // space parameter, and returns a JSON text. The replacer can be a function |
| 360 // that can replace values, or an array of strings that will select the keys. |
| 361 // A default replacer method can be provided. Use of the space parameter can |
| 362 // produce text that is more easily readable. |
| 363 |
| 364 var i; |
| 365 gap = ''; |
| 366 indent = ''; |
| 367 |
| 368 // If the space parameter is a number, make an indent string containing that |
| 369 // many spaces. |
| 370 |
| 371 if (typeof space === 'number') { |
| 372 for (i = 0; i < space; i += 1) { |
| 373 indent += ' '; |
| 374 } |
| 375 |
| 376 // If the space parameter is a string, it will be used as the indent string. |
| 377 |
| 378 } else if (typeof space === 'string') { |
| 379 indent = space; |
| 380 } |
| 381 |
| 382 // If there is a replacer, it must be a function or an array. |
| 383 // Otherwise, throw an error. |
| 384 |
| 385 rep = replacer; |
| 386 if (replacer && typeof replacer !== 'function' && |
| 387 (typeof replacer !== 'object' || |
| 388 typeof replacer.length !== 'number')) { |
| 389 throw new Error('JSON.stringify'); |
| 390 } |
| 391 |
| 392 // Make a fake root object containing our value under the key of ''. |
| 393 // Return the result of stringifying the value. |
| 394 |
| 395 return str('', {'': value}); |
| 396 }; |
| 397 } |
| 398 |
| 399 |
| 400 // If the JSON object does not yet have a parse method, give it one. |
| 401 |
| 402 if (typeof JSON.parse !== 'function') { |
| 403 JSON.parse = function (text, reviver) { |
| 404 |
| 405 // The parse method takes a text and an optional reviver function, and returns |
| 406 // a JavaScript value if the text is a valid JSON text. |
| 407 |
| 408 var j; |
| 409 |
| 410 function walk(holder, key) { |
| 411 |
| 412 // The walk method is used to recursively walk the resulting structure so |
| 413 // that modifications can be made. |
| 414 |
| 415 var k, v, value = holder[key]; |
| 416 if (value && typeof value === 'object') { |
| 417 for (k in value) { |
| 418 if (Object.hasOwnProperty.call(value, k)) { |
| 419 v = walk(value, k); |
| 420 if (v !== undefined) { |
| 421 value[k] = v; |
| 422 } else { |
| 423 delete value[k]; |
| 424 } |
| 425 } |
| 426 } |
| 427 } |
| 428 return reviver.call(holder, key, value); |
| 429 } |
| 430 |
| 431 |
| 432 // Parsing happens in four stages. In the first stage, we replace certain |
| 433 // Unicode characters with escape sequences. JavaScript handles many characters |
| 434 // incorrectly, either silently deleting them, or treating them as line endings. |
| 435 |
| 436 cx.lastIndex = 0; |
| 437 if (cx.test(text)) { |
| 438 text = text.replace(cx, function (a) { |
| 439 return '\\u' + |
| 440 ('0000' + a.charCodeAt(0).toString(16)).slice(-4); |
| 441 }); |
| 442 } |
| 443 |
| 444 // In the second stage, we run the text against regular expressions that look |
| 445 // for non-JSON patterns. We are especially concerned with '()' and 'new' |
| 446 // because they can cause invocation, and '=' because it can cause mutation. |
| 447 // But just to be safe, we want to reject all unexpected forms. |
| 448 |
| 449 // We split the second stage into 4 regexp operations in order to work around |
| 450 // crippling inefficiencies in IE's and Safari's regexp engines. First we |
| 451 // replace the JSON backslash pairs with '@' (a non-JSON character). Second, we |
| 452 // replace all simple value tokens with ']' characters. Third, we delete all |
| 453 // open brackets that follow a colon or comma or that begin the text. Finally, |
| 454 // we look to see that the remaining characters are only whitespace or ']' or |
| 455 // ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval. |
| 456 |
| 457 if (/^[\],:{}\s]*$/. |
| 458 test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@'). |
| 459 replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')
. |
| 460 replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) { |
| 461 |
| 462 // In the third stage we use the eval function to compile the text into a |
| 463 // JavaScript structure. The '{' operator is subject to a syntactic ambiguity |
| 464 // in JavaScript: it can begin a block or an object literal. We wrap the text |
| 465 // in parens to eliminate the ambiguity. |
| 466 |
| 467 j = eval('(' + text + ')'); |
| 468 |
| 469 // In the optional fourth stage, we recursively walk the new structure, passing |
| 470 // each name/value pair to a reviver function for possible transformation. |
| 471 |
| 472 return typeof reviver === 'function' ? |
| 473 walk({'': j}, '') : j; |
| 474 } |
| 475 |
| 476 // If the text is not JSON parseable, then a SyntaxError is thrown. |
| 477 |
| 478 throw new SyntaxError('JSON.parse'); |
| 479 }; |
| 480 } |
| 481 }()); |
OLD | NEW |