JSON.stringify()

JSON 通常用於與服務端交換資料。

在向伺服器傳送資料時一般是字串。

我們可以使用 JSON.stringify() 方法將 JavaScript 物件轉換為字串。

語法

JSON.stringify(value[, replacer[, space]])

引數說明：

• value:

  必需， 一個有效的 JSON 物件。

• replacer:

  可選。用於轉換結果的函式或陣列。

  如果 replacer 為函式，則 JSON.stringify 將呼叫該函式，並傳入每個成員的鍵和值。使用返回值而不是原始值。如果此函式返回 undefined，則排除成員。根物件的鍵是一個空字串：""。

  如果 replacer 是一個數組，則僅轉換該陣列中具有鍵值的成員。成員的轉換順序與鍵在陣列中的順序一樣。當 value 引數也為陣列時，將忽略 replacer 陣列。

• space:

  可選，文字新增縮排、空格和換行符，如果 space 是一個數字，則返回值文字在每個級別縮排指定數目的空格，如果 space 大於 10，則文字縮排 10 個空格。space 有可以使用非數字，如：\t。

JavaScript 物件轉換

例如我們向伺服器傳送以下資料：

var obj = { "name":"runoob", "alexa":10000, "site":"www.runoob.com"};
 

我們使用 JSON.stringify() 方法處理以上資料，將其轉換為字串：

var myJSON = JSON.stringify(obj);

myJSON 為字串。

我們可以將 myJSON 傳送到伺服器：

var obj = { "name":"runoob", "alexa":10000, "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

JavaScript 陣列轉換

我們也可以將 JavaScript 陣列轉換為 JSON 字串：

var arr = [ "Google", "Runoob", "Taobao", "Facebook" ];
var myJSON = JSON.stringify(arr);

myJSON 為字串。

我們可以將 myJSON 傳送到伺服器：

var arr = [ "Google", "Runoob", "Taobao", "Facebook" ];
var myJSON = JSON.stringify(arr);
document.getElementById("demo").innerHTML = myJSON;

異常

解析資料

JSON 不能儲存 Date 物件。

JSON.stringify() 會將所有日期轉換為字串。

var obj = { "name":"Runoob", "initDate":new Date(), "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
document.getElementById("demo").innerHTML = myJSON;

之後你可以再將字串轉換為 Date 物件。

解析函式

JSON 不允許包含函式，JSON.stringify() 會刪除 JavaScript 物件的函式，包括 key 和 value。

var obj = { "name":"Runoob", "alexa":function () {return 10000;}, "site":"www.runoob.com"};
var myJSON = JSON.stringify(obj);
 
document.getElementById("demo").innerHTML = myJSON;

我們可以在執行 JSON.stringify() 函式前將函式轉換為字串來避免以上問題的發生：

var obj = { "name":"Runoob", "alexa":function () {return 10000;}, "site":"www.runoob.com"};
obj.alexa = obj.alexa.toString();
var myJSON = JSON.stringify(obj);
 
document.getElementById("demo").innerHTML = myJSON;

不建議在 JSON 中使用函式。

瀏覽器支援

主流瀏覽器都支援 JSON.stringify() 函式：

• Firefox 3.5
• Internet Explorer 8
• Chrome
• Opera 10
• Safari 4