JSON.stringify 函數 (JavaScript)
文法:JSON.stringify(value [, replacer] [, space])
將 JavaScript 值轉換為 JavaScript 物件表示法 (Json) 字串。
value
必需。 要轉換的 JavaScript 值(通常是物件或陣列)。
replacer
可選。 用於轉換結果的函數或陣列。
如果 replacer 為函數,則 JSON.stringify 將呼叫該函數,並傳入每個成員的鍵和值。 使用傳回值而不是原始值。 如果此函數傳回 undefined,則排除成員。 根物件的鍵是一個空字串:""。
如果 replacer 是數組,則僅轉換該數組中具有鍵值的成員。 成員的轉換順序與鍵在陣列中的順序一樣。 當 value 參數也為數組時,將忽略 replacer 數組。
space
可選。 在返回值 JSON 文字中新增縮排、空格和換行符以使其更易於讀取。
如果省略 space,則將產生傳回值文本,而沒有任何額外空格。
如果 space 是數字,則傳回值文字在每個層級縮排指定數目的空格。 如果 space 大於 10,則文字縮排 10 個空格。
如果 space 是非空字串(例如「 」),則傳回值文字在每個層級中縮排字串中的字元。
如果 space 是長度大於 10 個字元的字串,則使用前 10 個字元。
如果 value 有 toJSON 方法,則 JSON.stringify 函數將使用該方法的傳回值。 如果 toJSON 方法的回傳值為 undefined,則不轉換成員。 這使物件能夠確定自己的 JSON 表示形式。
將不會轉換不具有 JSON 表示形式的值,例如 undefined。 在物件中,將丟棄這些值。 在陣列中,會將這些值替換為 null。
執行順序
在序列化過程中,如果 value 參數對應有 toJSON 方法,則 JSON.stringify 將首先呼叫 toJSON 方法。 如果該方法不存在,則使用原始值。 接下來,如果提供 replacer 參數,則該值(原始值或 toJSON 傳回值)將替換為 replacer 參數的傳回值。 最後,根據可選 space 參數向該值添加空格以產生最終的 JSON 文字。
此範例使用 JSON.stringify 將 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 時呼叫 toJSON 方法。
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.parse 將 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 ("
");
var newArr = JSON.parse(str);
while (newArr.length > 0) {
document.write(newArr.pop() "
");
}
// Output:
// ["a","b","c"]
// c
// b
// a