JSON.stringify 函式(JavaScript)
語法:JSON.stringify(value [, replacer] [, space])
將 JavaScript 值轉換為 JavaScript 物件表示法(JSON)字串。
參數說明:
value:必需。要轉換的 JavaScript 值(通常為物件或陣列)。
replacer:可選。用於轉換結果的函式或陣列。若為函式,JSON.stringify 會為每個成員呼叫它並傳入鍵與值,以回傳值取代原始值,若回傳 undefined 則排除該成員(根物件的鍵為空字串 "");若為陣列,則僅轉換該陣列中列出的鍵值成員,且當 value 本身也是陣列時將忽略 replacer 陣列。
space:可選。用來在回傳的 JSON 文字中添加縮排、空格與換行以便閱讀。若省略則不添加額外空格;若為數字則以該數量的空格縮排(超過 10 則以 10 計);若為非空字串(如「\t」)則以該字串縮排;若字串長度超過 10 個字元,則只取前 10 個字元。
若 value 具有 toJSON 方法,JSON.stringify 會使用該方法的回傳值;若 toJSON 回傳 undefined,則不轉換該成員,這讓物件能自行決定其 JSON 表示形式。不具 JSON 表示形式的值(如 undefined)不會被轉換:在物件中會被丟棄,在陣列中則被替換為 null。
執行順序:序列化時,若 value 對應有 toJSON 方法,JSON.stringify 會先呼叫它;接著若提供了 replacer 參數,則以它的回傳值取代該值;最後根據可選的 space 參數添加空格,生成最終的 JSON 文字。
以下範例將 contact 物件轉為 JSON 文字,並以 memberfilter 陣列只轉換 surname 與 phone 成員,省略 firstname:
復制代碼 代碼如下:
var contact = new Object();
contact.firstname = "Jesper";
contact.surname = "Aaberg";
contact.phone = ["555-0100", "555-0120"];
var memberfilter = new Array();
memberfilter[0] = "surname";
memberfilter[1] = "phone";
var jsonText = JSON.stringify(contact, memberfilter, "\t");
document.write(jsonText);
// Output:
// { "surname": "Aaberg", "phone": [ "555-0100", "555-0120" ] }
toJSON 方法(Date)(JavaScript)
語法:objectname.toJSON()
其中 objectname 為必需,代表需要進行 JSON 序列化的物件。toJSON 是 Date 物件(JavaScript)的內建成員,會回傳 UTC 時區的 ISO 格式日期字串(以 Z 後綴表示)。
以下範例自訂 toJSON 方法,將字串成員值轉為大寫,並在呼叫 JSON.stringify 時一併觸發:
復制代碼 代碼如下:
JavaScript
var contact = new Object();
contact.firstname = "Jesper";
contact.surname = "Aaberg";
contact.phone = ["555-0100", "555-0120"];
contact.toJSON = function(key)
{
var replacement = new Object();
for (var val in this)
{
if (typeof (this[val]) === 'string')
replacement[val] = this[val].toUpperCase();
else
replacement[val] = this[val]
}
return replacement;
};
var jsonText = JSON.stringify(contact);
/* The value of jsonText is:
'{"firstname":"JESPER","surname":"AABERG","phone":["555-0100","555-0120"]}'
*/
JSON.parse 函式(JavaScript)
將 JavaScript 物件表示法(JSON)字串轉換為物件。語法:JSON.parse(text [, reviver])
復制代碼 代碼如下:
text
必需。 一個有效的 JSON 字符串。
reviver
可選。 一個轉換結果的函數。 將為對象的每個成員調用此函數。 如果成員包含嵌套對象,則先於父對象轉換嵌套對象。 對於每個成員,會發生以下情況:
如果 reviver 返回一個有效值,則成員值將替換為轉換後的值。
如果 reviver 返回它接收的相同值,則不修改成員值。
如果 reviver 返回 null 或 undefined,則刪除成員。
以下範例將 JSON 字串轉為物件:
復制代碼 代碼如下:
var jsontext = '{"firstname":"Jesper","surname":"Aaberg","phone":["555-0100","555-0120"]}';
var contact = JSON.parse(jsontext);
document.write(contact.surname + ", " + contact.firstname);
// Output: Aaberg, Jesper
以下範例示範先用 JSON.stringify 把陣列轉為 JSON 字串,再用 JSON.parse 還原成陣列:
復制代碼 代碼如下:
var arr = ["a", "b", "c"];
var str = JSON.stringify(arr);
document.write(str);
document.write ("<br/>");
var newArr = JSON.parse(str);
while (newArr.length > 0) {
document.write(newArr.pop() + "<br/>");
}
// Output:
// ["a","b","c"]
// c
// b
// a