jQuery: jquery.json.js

http://api.jquery.com/jQuery.parseJSON/

http://www.json.org/json-zh.html

http://fineui.codeplex.com/SourceControl/latest

http://code.google.com/p/jquery-json/

https://github.com/Krinkle/jquery-json

jquery.json.js:

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200

/**  * jQuery JSON plugin v2.5.1  * https://github.com/Krinkle/jquery-json  *  * @author Brantley Harris, 2009-2011  * @author Timo Tijhof, 2011-2014  * @source This plugin is heavily influenced by MochiKit's serializeJSON, which is  *         copyrighted 2005 by Bob Ippolito.  * @source Brantley Harris wrote this plugin. It is based somewhat on the JSON.org  *         website's http://www.json.org/json2.js, which proclaims:  *         "NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.", a sentiment that  *         I uphold.  * @license MIT License <http://opensource.org/licenses/MIT>  */ (function ($) {     'use strict';       var escape = /["\\\x00-\x1f\x7f-\x9f]/g,         meta = {             '\b': '\\b',             '\t': '\\t',             '\n': '\\n',             '\f': '\\f',             '\r': '\\r',             '"': '\\"',             '\\': '\\\\'         },         hasOwn = Object.prototype.hasOwnProperty;       /**      * jQuery.toJSON      * Converts the given argument into a JSON representation.      *      * @param o {Mixed} The json-serializable *thing* to be converted      *      * If an object has a toJSON prototype, that will be used to get the representation.      * Non-integer/string keys are skipped in the object, as are keys that point to a      * function.      *      */     $.toJSON = typeof JSON === 'object' && JSON.stringify ? JSON.stringify : function (o) {         if (o === null) {             return 'null';         }           var pairs, k, name, val,             type = $.type(o);           if (type === 'undefined') {             return undefined;         }           // Also covers instantiated Number and Boolean objects,         // which are typeof 'object' but thanks to $.type, we         // catch them here. I don't know whether it is right         // or wrong that instantiated primitives are not         // exported to JSON as an {"object":..}.         // We choose this path because that's what the browsers did.         if (type === 'number' || type === 'boolean') {             return String(o);         }         if (type === 'string') {             return $.quoteString(o);         }         if (typeof o.toJSON === 'function') {             return $.toJSON(o.toJSON());         }         if (type === 'date') {             var month = o.getUTCMonth() + 1,                 day = o.getUTCDate(),                 year = o.getUTCFullYear(),                 hours = o.getUTCHours(),                 minutes = o.getUTCMinutes(),                 seconds = o.getUTCSeconds(),                 milli = o.getUTCMilliseconds();               if (month < 10) {                 month = '0' + month;             }             if (day < 10) {                 day = '0' + day;             }             if (hours < 10) {                 hours = '0' + hours;             }             if (minutes < 10) {                 minutes = '0' + minutes;             }             if (seconds < 10) {                 seconds = '0' + seconds;             }             if (milli < 100) {                 milli = '0' + milli;             }             if (milli < 10) {                 milli = '0' + milli;             }             return '"' + year + '-' + month + '-' + day + 'T' +                 hours + ':' + minutes + ':' + seconds +                 '.' + milli + 'Z"';         }           pairs = [];           if ($.isArray(o)) {             for (k = 0; k < o.length; k++) {                 pairs.push($.toJSON(o[k]) || 'null');             }             return '[' + pairs.join(',') + ']';         }           // Any other object (plain object, RegExp, ..)         // Need to do typeof instead of $.type, because we also         // want to catch non-plain objects.         if (typeof o === 'object') {             for (k in o) {                 // Only include own properties,                 // Filter out inherited prototypes                 if (hasOwn.call(o, k)) {                     // Keys must be numerical or string. Skip others                     type = typeof k;                     if (type === 'number') {                         name = '"' + k + '"';                     } else if (type === 'string') {                         name = $.quoteString(k);                     } else {                         continue;                     }                     type = typeof o[k];                       // Invalid values like these return undefined                     // from toJSON, however those object members                     // shouldn't be included in the JSON string at all.                     if (type !== 'function' && type !== 'undefined') {                         val = $.toJSON(o[k]);                         pairs.push(name + ':' + val);                     }                 }             }             return '{' + pairs.join(',') + '}';         }     };       /**      * jQuery.evalJSON      * Evaluates a given json string.      *      * @param str {String}      */     $.evalJSON = typeof JSON === 'object' && JSON.parse ? JSON.parse : function (str) {         /*jshint evil: true */         return eval('(' + str + ')');     };       /**      * jQuery.secureEvalJSON      * Evals JSON in a way that is *more* secure.      *      * @param str {String}      */     $.secureEvalJSON = typeof JSON === 'object' && JSON.parse ? JSON.parse : function (str) {         var filtered =             str             .replace(/\\["\\\/bfnrtu]/g, '@')             .replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')             .replace(/(?:^|:|,)(?:\s*\[)+/g, '');           if (/^[\],:{}\s]*$/.test(filtered)) {             /*jshint evil: true */             return eval('(' + str + ')');         }         throw new SyntaxError('Error parsing JSON, source is not valid.');     };       /**      * jQuery.quoteString      * Returns a string-repr of a string, escaping quotes intelligently.      * Mostly a support function for toJSON.      * Examples:      * >>> jQuery.quoteString('apple')      * "apple"      *      * >>> jQuery.quoteString('"Where are we going?", she asked.')      * "\"Where are we going?\", she asked."      */     $.quoteString = function (str) {         if (str.match(escape)) {             return '"' + str.replace(escape, function (a) {                 var c = meta[a];                 if (typeof c === 'string') {                     return c;                 }                 c = a.charCodeAt();                 return '\\u00' + Math.floor(c / 16).toString(16) + (c % 16).toString(16);             }) + '"';         }         return '"' + str + '"';     };   }(jQuery));

　　test.json:

?

1 2 3 4 5

{   "one": "Singular sensation",   "two": "Beady little eyes",   "three": "Little birds pitch by my doorstep" }

　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

<!DOCTYPE html> <html lang="en" dir="ltr"> <head>     <meta charset="utf-8">     <title>jQuery JSON Test Suite</title>     <link rel="stylesheet" href="../libs/qunitjs/qunit.css">     <script src="../libs/jquery/jquery.js"></script>     <script type="text/javascript"> $.getJSON( "ajax/test.json", function( data ) {   var items = [];   $.each( data, function( key, val ) {     items.push( "<li id='" + key + "'>" + val + "</li>" );   });      $( "<ul/>", {     "class": "my-new-list",     html: items.join( "" )   }).appendTo( "body" ); }); </script> </head> <body>   </body>   </html>

　　

　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

<!DOCTYPE html> <html lang="en" dir="ltr"> <head>     <meta charset="utf-8">     <title>jQuery JSON Test Suite</title>     <link rel="stylesheet" href="../libs/qunitjs/qunit.css">     <script src="../libs/jquery/jquery.js"></script>     <script type="text/javascript"> $.getJSON( "ajax/test.json", function( data ) {   var items = [];   $.each( data, function( key, val ) {     items.push( "<li id='" + key + "'>" + val + "</li>" );   });      $( "<ul/>", {     "class": "my-new-list",     html: items.join( "" )   }).appendTo( "#geovindu" ); }); </script> </head> <body> <div id="geovindu"></div> </body>   </html>

　　

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46

<!DOCTYPE html> <html lang="en" dir="ltr"> <head>     <meta charset="utf-8">     <title>jQuery JSON Test Suite</title>     <link rel="stylesheet" href="../libs/qunitjs/qunit.css">     <script src="../libs/jquery/jquery.js"></script>   <script type="text/javascript"> $.ajax({      type: "GET",      url: "ajax/test.json",      async: true,      beforeSend: function(x) {       if(x && x.overrideMimeType) {        x.overrideMimeType("application/j-son;charset=UTF-8");       }  },/**/  contentType: "application/json; charset=utf-8",     dataType: "json",  success: function(data){      var items = [];   $.each( data, function( key, val ) {     items.push( "<li id='" + key + "'>" + val + "</li>" );   });      $( "<ul/>", {     "class": "my-new-list",     html: items.join( "" )   }).appendTo( "#geovindu" );        }, error: function (XMLHttpRequest, textStatus, errorThrown) {       alert(errorThrown);   }   }); </script> </head>   <body> <div id="geovindu"></div>   </body>   </html>

　　

 

参数：

1.url:
要求为String类型的参数，（默认为当前页地址）发送请求的地址。

2.type:
要求为String类型的参数，请求方式（post或get）默认为get。注意其他http请求方法，例如put和delete也可以使用，但仅部分浏览器支持。

3.timeout:
要求为Number类型的参数，设置请求超时时间（毫秒）。此设置将覆盖$.ajaxSetup()方法的全局设置。

4.async:
要求为Boolean类型的参数，默认设置为true，所有请求均为异步请求。如果需要发送同步请求，请将此选项设置为false。注意，同步请求将锁住浏览器，用户其他操作必须等待请求完成才可以执行。

5.cache:
要求为Boolean类型的参数，默认为true（当dataType为script时，默认为false），设置为false将不会从浏览器缓存中加载请求信息。

6.data:
要求为Object或String类型的参数，发送到服务器的数据。如果已经不是字符串，将自动转换为字符串格式。get请求中将附加在url后。防止这种自动转换，可以查看　　processData选项。对象必须为key/value格式，例如{foo1:"bar1",foo2:"bar2"}转换为&foo1=bar1&foo2=bar2。如果是数组，JQuery将自动为不同值对应同一个名称。例如{foo:["bar1","bar2"]}转换为&foo=bar1&foo=bar2。

7.dataType:
要求为String类型的参数，预期服务器返回的数据类型。如果不指定，JQuery将自动根据http包mime信息返回responseXML或responseText，并作为回调函数参数传递。可用的类型如下：
xml：返回XML文档，可用JQuery处理。
html：返回纯文本HTML信息；包含的script标签会在插入DOM时执行。
script：返回纯文本JavaScript代码。不会自动缓存结果。除非设置了cache参数。注意在远程请求时（不在同一个域下），所有post请求都将转为get请求。
json：返回JSON数据。
jsonp：JSONP格式。使用SONP形式调用函数时，例如myurl?callback=?，JQuery将自动替换后一个“?”为正确的函数名，以执行回调函数。
text：返回纯文本字符串。

8.beforeSend：
要求为Function类型的参数，发送请求前可以修改XMLHttpRequest对象的函数，例如添加自定义HTTP头。在beforeSend中如果返回false可以取消本次ajax请求。XMLHttpRequest对象是惟一的参数。
function(XMLHttpRequest){
this; //调用本次ajax请求时传递的options参数
}
9.complete：
要求为Function类型的参数，请求完成后调用的回调函数（请求成功或失败时均调用）。参数：XMLHttpRequest对象和一个描述成功请求类型的字符串。
function(XMLHttpRequest, textStatus){
this; //调用本次ajax请求时传递的options参数
}

10.success：要求为Function类型的参数，请求成功后调用的回调函数，有两个参数。
(1)由服务器返回，并根据dataType参数进行处理后的数据。
(2)描述状态的字符串。
function(data, textStatus){
//data可能是xmlDoc、jsonObj、html、text等等
this; //调用本次ajax请求时传递的options参数
}

11.error:
要求为Function类型的参数，请求失败时被调用的函数。该函数有3个参数，即XMLHttpRequest对象、错误信息、捕获的错误对象(可选)。ajax事件函数如下：
function(XMLHttpRequest, textStatus, errorThrown){
//通常情况下textStatus和errorThrown只有其中一个包含信息
this; //调用本次ajax请求时传递的options参数
}

12.contentType：
要求为String类型的参数，当发送信息至服务器时，内容编码类型默认为"application/x-www-form-urlencoded"。该默认值适合大多数应用场合。

13.dataFilter：
要求为Function类型的参数，给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据，type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function(data, type){
//返回处理后的数据
return data;
}

14.dataFilter：
要求为Function类型的参数，给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数。data是Ajax返回的原始数据，type是调用jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进一步处理。
function(data, type){
//返回处理后的数据
return data;
}

15.global：
要求为Boolean类型的参数，默认为true。表示是否触发全局ajax事件。设置为false将不会触发全局ajax事件，ajaxStart或ajaxStop可用于控制各种ajax事件。

16.ifModified：
要求为Boolean类型的参数，默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false，即忽略头信息。

17.jsonp：
要求为String类型的参数，在一个jsonp请求中重写回调函数的名字。该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分，例如{jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。

18.username：
要求为String类型的参数，用于响应HTTP访问认证请求的用户名。

19.password：
要求为String类型的参数，用于响应HTTP访问认证请求的密码。

20.processData：
要求为Boolean类型的参数，默认为true。默认情况下，发送的数据将被转换为对象（从技术角度来讲并非字符串）以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息，请设置为false。

21.scriptCharset：
要求为String类型的参数，只有当请求时dataType为"jsonp"或者"script"，并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。