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" }'
);
// 拋出錯誤
|