jQuery.parseJSON()函數用於將格式完好的JSON字元串轉為與之對應的JavaScript對象。 所謂”格式完好”,就是要求指定的字元串必須符合嚴格的JSON格式,例如:屬性名稱必須加雙引號、字元串值也必須用雙引號。 如果傳入一個格式不”完好”的JSON字元串將拋出一個JS異常,例如: ...
jQuery.parseJSON()函數用於將格式完好的JSON字元串轉為與之對應的JavaScript對象。
所謂”格式完好”,就是要求指定的字元串必須符合嚴格的JSON格式,例如:屬性名稱必須加雙引號、字元串值也必須用雙引號。
如果傳入一個格式不”完好”的JSON字元串將拋出一個JS異常,例如:以下字元串均符合JSON格式,但它們不是格式完好的JSON字元串(因此會拋出異常):
?1 2 3 4 |
// 以下均是字元串值,省略了兩側的引號,以便於展現內容
{id: 1} // id是屬性名稱,必須加雙引號
{ 'id' : 1} // id是屬性名稱,必須用雙引號(不能用單引號)
{ "name" : 'CodePlayer' } // name屬性的值是字元串,必須用雙引號(不能用單引號)
|
JSON標準不允許字元串中出現”控制字元”,例如:一個Tab或換行符。
?1 2 3 |
$.parseJSON( '{"name": "Code\tPlayer\n"}' ); // 多數情況下,它會拋出一個錯誤,因為JS解析器會將字元串中的\t或\n等轉義直接視作字面值,起到Tab或換行的效果。
//正確寫法應該如下(使用兩個反斜杠,以免被JS解析器直接轉義\t或\n):
$.parseJSON( '{"name": "Code\\tPlayer\\n"}' );
|
如果瀏覽器提供了一個本地的JSON.parse()方法,則jQuery將使用它來解析JSON字元串。
在jQuery插件 1.9之前(不含1.9):如果傳入一個空字元串、null或undefined,該函數將返回null,而不是拋出一個錯誤,即使它不是有效的JSON字元串。
該函數屬於全局的jQuery對象。
語法
jQuery 1.4.1 新增該靜態函數。
jQuery.parseJSON( jsonString ) 參數
參數 描述 jsonString String類型需要解析並轉為JS對象的JSON格式字元串。 返回值
jQuery.parseJSON()函數的返回值為任意類型,返回解析指定JSON字元串後的JavaScript表示。
示例&說明
以下是與jQuery.parseJSON()函數相關的jQuery示例代碼,以演示jQuery.parseJSON()函數的具體用法:
?1 2 3 4 5 6 7 8 9 10 |
var result1 = $.parseJSON( "{}" ); // 一個空的Object對象
var result2 = $.parseJSON( '{ "name": "CodePlayer", "age": 1 }' ); // 一個Object對象
alert( result2.name ); // CodePlayer
var result3 = $.parseJSON( '[ 1, true, "CodePlayer" ]' ); // 一個Object對象
alert( result3[2] ); // CodePlayer
var result4 = $.parseJSON( 'true' ); // 布爾值:true
var result5 = $.parseJSON( 'null' ); // null
var result6 = $.parseJSON( '0' ); // 整數:0
var result7 = $.parseJSON( '"專註於編程開發技術分享"' ); // 字元串值:專註於編程開發技術分享
var result8 = $.parseJSON( "\"專註於編程開發技術分享\"" ); // 字元串值:專註於編程開發技術分享
|
1 2 3 4 5 6 7 8 9 10 11 12 |
/* 以下均是無效的JSON字元串或非常規的參數值 */
var result9 = $.parseJSON( 100 ); // 1.9之前返回null;1.9+返回100
var result10 = $.parseJSON( 1.23 ); // 1.9之前返回null;1.9+返回1.23
var result11 = $.parseJSON( true ); // 1.9之前返回null;1.9+返回true
var result12 = $.parseJSON( null ); // 返回null
var result13 = $.parseJSON( "" ); // 1.9之前返回null;1.9+拋出錯誤
var result14 = $.parseJSON( undefined ); // 1.9之前返回null;1.9+拋出錯誤
var result15 = $.parseJSON( "undefined" ); // 拋出錯誤
var result16 = $.parseJSON( "12x;xx'無效的JSON字元串x4546" ); // 拋出錯誤
var result17 = $.parseJSON( '{ name: "CodePlayer" , age: 1 } ' ); // 拋出錯誤
var result18 = $.parseJSON( ' { "name" : \ 'CodePlayer\', "age": 1 }' ); // 拋出錯誤
var result19 = $.parseJSON( '{ "name": "Code\tPlayer\n" }' ); // 拋出錯誤
|