src/cm/media/js/lib/yui/yui_3.10.3/build/querystring-stringify/querystring-stringify.js
author gibus
Tue, 16 Jul 2013 14:29:46 +0200
changeset 525 89ef5ed3c48b
permissions -rw-r--r--
Upgrades to yui 3.10.3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
525
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     1
/*
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     2
YUI 3.10.3 (build 2fb5187)
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     3
Copyright 2013 Yahoo! Inc. All rights reserved.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     4
Licensed under the BSD License.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     5
http://yuilibrary.com/license/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     6
*/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     7
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     8
YUI.add('querystring-stringify', function (Y, NAME) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
     9
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    10
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    11
 * Provides Y.QueryString.stringify method for converting objects to Query Strings.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    12
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    13
 * @module querystring
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    14
 * @submodule querystring-stringify
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    15
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    16
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    17
var QueryString = Y.namespace("QueryString"),
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    18
    stack = [],
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    19
    L = Y.Lang;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    20
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    21
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    22
 * Provides Y.QueryString.escape method to be able to override default encoding
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    23
 * method.  This is important in cases where non-standard delimiters are used, if
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    24
 * the delimiters would not normally be handled properly by the builtin
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    25
 * (en|de)codeURIComponent functions.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    26
 * Default: encodeURIComponent
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    27
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    28
 * @method escape
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    29
 * @for QueryString
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    30
 * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    31
 **/
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    32
QueryString.escape = encodeURIComponent;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    33
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    34
/**
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    35
 * <p>Converts an arbitrary value to a Query String representation.</p>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    36
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    37
 * <p>Objects with cyclical references will trigger an exception.</p>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    38
 *
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    39
 * @method stringify
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    40
 * @for QueryString
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    41
 * @public
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    42
 * @param obj {Variant} any arbitrary value to convert to query string
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    43
 * @param cfg {Object} (optional) Configuration object.  The three
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    44
 * supported configurations are:
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    45
 * <ul><li>sep: When defined, the value will be used as the key-value
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    46
 * separator.  The default value is "&".</li>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    47
 * <li>eq: When defined, the value will be used to join the key to
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    48
 * the value.  The default value is "=".</li>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    49
 * <li>arrayKey: When set to true, the key of an array will have the
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    50
 * '[]' notation appended to the key.  The default value is false.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    51
 * </li></ul>
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    52
 * @param name {String} (optional) Name of the current key, for handling children recursively.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    53
 * @static
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    54
 */
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    55
QueryString.stringify = function (obj, c, name) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    56
    var begin, end, i, l, n, s,
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    57
        sep = c && c.sep ? c.sep : "&",
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    58
        eq = c && c.eq ? c.eq : "=",
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    59
        aK = c && c.arrayKey ? c.arrayKey : false;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    60
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    61
    if (L.isNull(obj) || L.isUndefined(obj) || L.isFunction(obj)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    62
        return name ? QueryString.escape(name) + eq : '';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    63
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    64
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    65
    if (L.isBoolean(obj) || Object.prototype.toString.call(obj) === '[object Boolean]') {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    66
        obj =+ obj;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    67
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    68
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    69
    if (L.isNumber(obj) || L.isString(obj)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    70
        return QueryString.escape(name) + eq + QueryString.escape(obj);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    71
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    72
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    73
    if (L.isArray(obj)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    74
        s = [];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    75
        name = aK ? name + '[]' : name;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    76
        l = obj.length;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    77
        for (i = 0; i < l; i++) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    78
            s.push( QueryString.stringify(obj[i], c, name) );
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    79
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    80
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    81
        return s.join(sep);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    82
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    83
    // now we know it's an object.
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    84
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    85
    // Check for cyclical references in nested objects
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    86
    for (i = stack.length - 1; i >= 0; --i) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    87
        if (stack[i] === obj) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    88
            throw new Error("QueryString.stringify. Cyclical reference");
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    89
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    90
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    91
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    92
    stack.push(obj);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    93
    s = [];
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    94
    begin = name ? name + '[' : '';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    95
    end = name ? ']' : '';
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    96
    for (i in obj) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    97
        if (obj.hasOwnProperty(i)) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    98
            n = begin + i + end;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
    99
            s.push(QueryString.stringify(obj[i], c, n));
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   100
        }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   101
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   102
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   103
    stack.pop();
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   104
    s = s.join(sep);
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   105
    if (!s && name) {
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   106
        return name + "=";
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   107
    }
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   108
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   109
    return s;
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   110
};
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   111
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   112
89ef5ed3c48b Upgrades to yui 3.10.3
gibus
parents:
diff changeset
   113
}, '3.10.3', {"requires": ["yui-base"]});