src/cm/media/js/lib/yui/yui3.0.0/build/json/json.js
author raph
Mon, 23 Nov 2009 15:14:29 +0100
changeset 0 40c8f766c9b8
permissions -rw-r--r--
import from internal svn r 4007
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     1
/*
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     2
Copyright (c) 2009, Yahoo! Inc. All rights reserved.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     3
Code licensed under the BSD License:
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     4
http://developer.yahoo.net/yui/license.txt
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     5
version: 3.0.0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     6
build: 1549
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     7
*/
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     8
YUI.add('json-parse', function(Y) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     9
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    10
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    11
 * <p>The JSON module adds support for serializing JavaScript objects into
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    12
 * JSON strings and parsing JavaScript objects from strings in JSON format.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    13
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    14
 * <p>The JSON namespace is added to your YUI instance including static methods
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    15
 * Y.JSON.parse(..) and Y.JSON.stringify(..).</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    16
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    17
 * <p>The functionality and method signatures follow the ECMAScript 5
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    18
 * specification.  In browsers with native JSON support, the native
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    19
 * implementation is used.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    20
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    21
 * <p>The <code>json</code> module is a rollup of <code>json-parse</code> and
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    22
 * <code>json-stringify</code>.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    23
 * 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    24
 * <p>As their names suggest, <code>json-parse</code> adds support for parsing
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    25
 * JSON data (Y.JSON.parse) and <code>json-stringify</code> for serializing
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    26
 * JavaScript data into JSON strings (Y.JSON.stringify).  You may choose to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    27
 * include either of the submodules individually if you don't need the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    28
 * complementary functionality, or include the rollup for both.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    29
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    30
 * @module json
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    31
 * @class JSON
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    32
 * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    33
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    34
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    35
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    36
 * Provides Y.JSON.parse method to accept JSON strings and return native
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    37
 * JavaScript objects.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    38
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    39
 * @module json
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    40
 * @submodule json-parse
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    41
 * @for JSON
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    42
 * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    43
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    44
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    45
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    46
// All internals kept private for security reasons
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    47
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    48
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    49
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    50
     * Alias to native browser implementation of the JSON object if available.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    51
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    52
     * @property Native
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    53
     * @type {Object}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    54
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    55
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    56
var _JSON  = Y.config.win.JSON,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    57
    Native = (Object.prototype.toString.call(_JSON) === '[object JSON]' && _JSON),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    58
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    59
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    60
     * Replace certain Unicode characters that JavaScript may handle incorrectly
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    61
     * during eval--either by deleting them or treating them as line
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    62
     * endings--with escape sequences.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    63
     * IMPORTANT NOTE: This regex will be used to modify the input if a match is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    64
     * found.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    65
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    66
     * @property _UNICODE_EXCEPTIONS
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    67
     * @type {RegExp}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    68
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    69
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    70
    _UNICODE_EXCEPTIONS = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    71
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    72
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    73
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    74
     * First step in the safety evaluation.  Regex used to replace all escape
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    75
     * sequences (i.e. "\\", etc) with '@' characters (a non-JSON character).
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    76
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    77
     * @property _ESCAPES
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    78
     * @type {RegExp}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    79
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    80
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    81
    _ESCAPES = /\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    82
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    83
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    84
     * Second step in the safety evaluation.  Regex used to replace all simple
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    85
     * values with ']' characters.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    86
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    87
     * @property _VALUES
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    88
     * @type {RegExp}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    89
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    90
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    91
    _VALUES  = /"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    92
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    93
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    94
     * Third step in the safety evaluation.  Regex used to remove all open
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    95
     * square brackets following a colon, comma, or at the beginning of the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    96
     * string.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    97
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    98
     * @property _BRACKETS
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    99
     * @type {RegExp}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   100
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   101
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   102
    _BRACKETS = /(?:^|:|,)(?:\s*\[)+/g,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   103
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   104
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   105
     * Final step in the safety evaluation.  Regex used to test the string left
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   106
     * after all previous replacements for invalid characters.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   107
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   108
     * @property _UNSAFE
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   109
     * @type {RegExp}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   110
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   111
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   112
    _UNSAFE = /[^\],:{}\s]/,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   113
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   114
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   115
     * Replaces specific unicode characters with their appropriate \unnnn
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   116
     * format. Some browsers ignore certain characters during eval.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   117
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   118
     * @method escapeException
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   119
     * @param c {String} Unicode character
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   120
     * @return {String} the \unnnn escapement of the character
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   121
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   122
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   123
    _escapeException = function (c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   124
        return '\\u'+('0000'+(+(c.charCodeAt(0))).toString(16)).slice(-4);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   125
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   126
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   127
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   128
     * Traverses nested objects, applying a reviver function to each (key,value)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   129
     * from the scope if the key:value's containing object.  The value returned
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   130
     * from the function will replace the original value in the key:value pair.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   131
     * If the value returned is undefined, the key will be omitted from the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   132
     * returned object.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   133
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   134
     * @method _revive
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   135
     * @param data {MIXED} Any JavaScript data
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   136
     * @param reviver {Function} filter or mutation function
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   137
     * @return {MIXED} The results of the filtered data
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   138
     * @private
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   139
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   140
    _revive = function (data, reviver) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   141
        var walk = function (o,key) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   142
            var k,v,value = o[key];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   143
            if (value && typeof value === 'object') {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   144
                for (k in value) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   145
                    if (value.hasOwnProperty(k)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   146
                        v = walk(value, k);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   147
                        if (v === undefined) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   148
                            delete value[k];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   149
                        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   150
                            value[k] = v;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   151
                        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   152
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   153
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   154
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   155
            return reviver.call(o,key,value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   156
        };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   157
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   158
        return typeof reviver === 'function' ? walk({'':data},'') : data;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   159
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   160
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   161
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   162
     * Parse a JSON string, returning the native JavaScript representation.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   163
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   164
     * @param s {string} JSON string data
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   165
     * @param reviver {function} (optional) function(k,v) passed each key value
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   166
     *          pair of object literals, allowing pruning or altering values
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   167
     * @return {MIXED} the native JavaScript representation of the JSON string
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   168
     * @throws SyntaxError
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   169
     * @method parse
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   170
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   171
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   172
    // JavaScript implementation in lieu of native browser support.  Based on
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   173
    // the json2.js library from http://json.org
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   174
    _parse = function (s,reviver) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   175
        if (typeof s === 'string') {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   176
            // Replace certain Unicode characters that are otherwise handled
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   177
            // incorrectly by some browser implementations.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   178
            // NOTE: This modifies the input if such characters are found!
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   179
            s = s.replace(_UNICODE_EXCEPTIONS, _escapeException);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   180
            
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   181
            // Test for any remaining invalid characters
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   182
            if (!_UNSAFE.test(s.replace(_ESCAPES,'@').
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   183
                                 replace(_VALUES,']').
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   184
                                 replace(_BRACKETS,''))) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   185
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   186
                // Eval the text into a JavaScript data structure, apply any
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   187
                // reviver function, and return
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   188
                return _revive( eval('(' + s + ')'), reviver );
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   189
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   190
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   191
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   192
        throw new SyntaxError('JSON.parse');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   193
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   194
    
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   195
Y.namespace('JSON').parse = function (s,reviver) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   196
    return Native && Y.JSON.useNativeParse ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   197
        Native.parse(s,reviver) : _parse(s,reviver);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   198
};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   199
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   200
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   201
 * Leverage native JSON parse if the browser has a native implementation.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   202
 * In general, this is a good idea.  See the Known Issues section in the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   203
 * JSON user guide for caveats.  The default value is true for browsers with
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   204
 * native JSON support.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   205
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   206
 * @property useNativeParse
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   207
 * @type Boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   208
 * @default true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   209
 * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   210
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   211
Y.JSON.useNativeParse = !!Native;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   212
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   213
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   214
}, '3.0.0' );
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   215
YUI.add('json-stringify', function(Y) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   216
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   217
/**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   218
 * Provides Y.JSON.stringify method for converting objects to JSON strings.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   219
 *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   220
 * @module json
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   221
 * @submodule json-stringify
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   222
 * @for JSON
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   223
 * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   224
 */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   225
var _JSON     = Y.config.win.JSON,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   226
    Lang      = Y.Lang,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   227
    isFunction= Lang.isFunction,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   228
    isObject  = Lang.isObject,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   229
    isArray   = Lang.isArray,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   230
    _toStr    = Object.prototype.toString,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   231
    Native    = (_toStr.call(_JSON) === '[object JSON]' && _JSON),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   232
    UNDEFINED = 'undefined',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   233
    OBJECT    = 'object',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   234
    NULL      = 'null',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   235
    STRING    = 'string',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   236
    NUMBER    = 'number',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   237
    BOOLEAN   = 'boolean',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   238
    DATE      = 'date',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   239
    _allowable= {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   240
        'undefined'        : UNDEFINED,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   241
        'string'           : STRING,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   242
        '[object String]'  : STRING,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   243
        'number'           : NUMBER,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   244
        '[object Number]'  : NUMBER,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   245
        'boolean'          : BOOLEAN,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   246
        '[object Boolean]' : BOOLEAN,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   247
        '[object Date]'    : DATE,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   248
        '[object RegExp]'  : OBJECT
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   249
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   250
    EMPTY     = '',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   251
    OPEN_O    = '{',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   252
    CLOSE_O   = '}',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   253
    OPEN_A    = '[',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   254
    CLOSE_A   = ']',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   255
    COMMA     = ',',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   256
    COMMA_CR  = ",\n",
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   257
    CR        = "\n",
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   258
    COLON     = ':',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   259
    COLON_SP  = ': ',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   260
    QUOTE     = '"',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   261
    // Regex used to capture characters that need escaping before enclosing
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   262
    // their containing string in quotes.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   263
    _SPECIAL_CHARS = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   264
    // Character substitution map for common escapes and special characters.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   265
    _CHARS = {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   266
        '\b': '\\b',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   267
        '\t': '\\t',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   268
        '\n': '\\n',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   269
        '\f': '\\f',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   270
        '\r': '\\r',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   271
        '"' : '\\"',
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   272
        '\\': '\\\\'
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   273
    };
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   274
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   275
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   276
// Utility function used to determine how to serialize a variable.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   277
function _type(o) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   278
    var t = typeof o;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   279
    return  _allowable[t] ||              // number, string, boolean, undefined
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   280
            _allowable[_toStr.call(o)] || // Number, String, Boolean, Date
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   281
            (t === OBJECT ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   282
                (o ? OBJECT : NULL) :     // object, array, null, misc natives
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   283
                UNDEFINED);               // function, unknown
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   284
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   285
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   286
// Escapes a special character to a safe Unicode representation
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   287
function _char(c) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   288
    if (!_CHARS[c]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   289
        _CHARS[c] =  '\\u'+('0000'+(+(c.charCodeAt(0))).toString(16)).slice(-4);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   290
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   291
    return _CHARS[c];
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   292
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   293
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   294
// Enclose escaped strings in quotes
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   295
function _string(s) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   296
    return QUOTE + s.replace(_SPECIAL_CHARS, _char) + QUOTE;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   297
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   298
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   299
// Adds the provided space to the beginning of every line in the input string
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   300
function _indent(s,space) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   301
    return s.replace(/^/gm, space);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   302
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   303
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   304
// JavaScript implementation of stringify (see API declaration of stringify)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   305
function _stringify(o,w,space) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   306
    if (o === undefined) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   307
        return undefined;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   308
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   309
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   310
    var replacer = isFunction(w) ? w : null,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   311
        format   = _toStr.call(space).match(/String|Number/) || [],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   312
        _date    = Y.JSON.dateToString,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   313
        stack    = [],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   314
        tmp,i,len;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   315
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   316
    if (replacer || !isArray(w)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   317
        w = undefined;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   318
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   319
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   320
    // Ensure whitelist keys are unique (bug 2110391)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   321
    if (w) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   322
        tmp = {};
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   323
        for (i = 0, len = w.length; i < len; ++i) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   324
            tmp[w[i]] = true;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   325
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   326
        w = tmp;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   327
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   328
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   329
    // Per the spec, strings are truncated to 10 characters and numbers
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   330
    // are converted to that number of spaces (max 10)
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   331
    space = format[0] === 'Number' ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   332
                new Array(Math.min(Math.max(0,space),10)+1).join(" ") :
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   333
                (space || EMPTY).slice(0,10);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   334
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   335
    function _serialize(h,key) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   336
        var value = h[key],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   337
            t     = _type(value),
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   338
            a     = [],
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   339
            colon = space ? COLON_SP : COLON,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   340
            arr, i, keys, k, v;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   341
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   342
        // Per the ECMA 5 spec, toJSON is applied before the replacer is
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   343
        // called.  Also per the spec, Date.prototype.toJSON has been added, so
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   344
        // Date instances should be serialized prior to exposure to the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   345
        // replacer.  I disagree with this decision, but the spec is the spec.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   346
        if (isObject(value) && isFunction(value.toJSON)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   347
            value = value.toJSON(key);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   348
        } else if (t === DATE) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   349
            value = _date(value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   350
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   351
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   352
        if (isFunction(replacer)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   353
            value = replacer.call(h,key,value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   354
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   355
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   356
        if (value !== h[key]) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   357
            t = _type(value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   358
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   359
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   360
        switch (t) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   361
            case DATE    : // intentional fallthrough.  Pre-replacer Dates are
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   362
                           // serialized in the toJSON stage.  Dates here would
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   363
                           // have been produced by the replacer.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   364
            case OBJECT  : break;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   365
            case STRING  : return _string(value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   366
            case NUMBER  : return isFinite(value) ? value+EMPTY : NULL;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   367
            case BOOLEAN : return value+EMPTY;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   368
            case NULL    : return NULL;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   369
            default      : return undefined;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   370
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   371
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   372
        // Check for cyclical references in nested objects
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   373
        for (i = stack.length - 1; i >= 0; --i) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   374
            if (stack[i] === value) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   375
                throw new Error("JSON.stringify. Cyclical reference");
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   376
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   377
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   378
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   379
        arr = isArray(value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   380
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   381
        // Add the object to the processing stack
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   382
        stack.push(value);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   383
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   384
        if (arr) { // Array
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   385
            for (i = value.length - 1; i >= 0; --i) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   386
                a[i] = _serialize(value, i) || NULL;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   387
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   388
        } else {   // Object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   389
            // If whitelist provided, take only those keys
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   390
            keys = w || value;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   391
            i = 0;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   392
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   393
            for (k in keys) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   394
                if (keys.hasOwnProperty(k)) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   395
                    v = _serialize(value, k);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   396
                    if (v) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   397
                        a[i++] = _string(k) + colon + v;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   398
                    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   399
                }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   400
            }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   401
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   402
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   403
        // remove the array from the stack
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   404
        stack.pop();
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   405
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   406
        if (space && a.length) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   407
            return arr ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   408
                OPEN_A + CR + _indent(a.join(COMMA_CR), space) + CR + CLOSE_A :
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   409
                OPEN_O + CR + _indent(a.join(COMMA_CR), space) + CR + CLOSE_O;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   410
        } else {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   411
            return arr ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   412
                OPEN_A + a.join(COMMA) + CLOSE_A :
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   413
                OPEN_O + a.join(COMMA) + CLOSE_O;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   414
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   415
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   416
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   417
    // process the input
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   418
    return _serialize({'':o},'');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   419
}
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   420
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   421
Y.mix(Y.namespace('JSON'),{
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   422
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   423
     * Leverage native JSON stringify if the browser has a native
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   424
     * implementation.  In general, this is a good idea.  See the Known Issues
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   425
     * section in the JSON user guide for caveats.  The default value is true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   426
     * for browsers with native JSON support.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   427
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   428
     * @property JSON.useNativeStringify
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   429
     * @type Boolean
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   430
     * @default true
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   431
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   432
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   433
    useNativeStringify : !!Native,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   434
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   435
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   436
     * Serializes a Date instance as a UTC date string.  Used internally by
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   437
     * stringify.  Override this method if you need Dates serialized in a
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   438
     * different format.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   439
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   440
     * @method dateToString
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   441
     * @param d {Date} The Date to serialize
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   442
     * @return {String} stringified Date in UTC format YYYY-MM-DDTHH:mm:SSZ
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   443
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   444
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   445
    dateToString : function (d) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   446
        function _zeroPad(v) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   447
            return v < 10 ? '0' + v : v;
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   448
        }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   449
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   450
        return d.getUTCFullYear()           + '-' +
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   451
              _zeroPad(d.getUTCMonth() + 1) + '-' +
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   452
              _zeroPad(d.getUTCDate())      + 'T' +
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   453
              _zeroPad(d.getUTCHours())     + COLON +
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   454
              _zeroPad(d.getUTCMinutes())   + COLON +
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   455
              _zeroPad(d.getUTCSeconds())   + 'Z';
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   456
    },
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   457
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   458
    /**
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   459
     * <p>Converts an arbitrary value to a JSON string representation.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   460
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   461
     * <p>Objects with cyclical references will trigger an exception.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   462
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   463
     * <p>If a whitelist is provided, only matching object keys will be
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   464
     * included.  Alternately, a replacer function may be passed as the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   465
     * second parameter.  This function is executed on every value in the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   466
     * input, and its return value will be used in place of the original value.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   467
     * This is useful to serialize specialized objects or class instances.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   468
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   469
     * <p>If a positive integer or non-empty string is passed as the third
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   470
     * parameter, the output will be formatted with carriage returns and
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   471
     * indentation for readability.  If a String is passed (such as "\t") it
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   472
     * will be used once for each indentation level.  If a number is passed,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   473
     * that number of spaces will be used.</p>
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   474
     *
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   475
     * @method stringify
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   476
     * @param o {MIXED} any arbitrary value to convert to JSON string
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   477
     * @param w {Array|Function} (optional) whitelist of acceptable object
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   478
     *                  keys to include, or a replacer function to modify the
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   479
     *                  raw value before serialization
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   480
     * @param ind {Number|String} (optional) indentation character or depth of
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   481
     *                  spaces to format the output.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   482
     * @return {string} JSON string representation of the input
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   483
     * @static
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   484
     */
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   485
    stringify : function (o,w,ind) {
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   486
        return Native && Y.JSON.useNativeStringify ?
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   487
            Native.stringify(o,w,ind) : _stringify(o,w,ind);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   488
    }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   489
});
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   490
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   491
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   492
}, '3.0.0' );
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   493
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   494
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   495
YUI.add('json', function(Y){}, '3.0.0' ,{use:['json-parse', 'json-stringify']});
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
   496