DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> JSON基礎
透透徹徹搞懂 JSON 的 stringify、toJSON 與 parse 函式
編輯:JSON基礎     

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

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved