JSON(JavaScript Object Notation)是一種輕量級的數據交換格式,採用完全獨立於語言的純文本形式。因為它本身就是 JavaScript 對象表示語法的子集,所以在 JS 中處理 JSON 不需要任何額外的 API 或工具包——這也是它比 XML 更小、更快、更易解析的原因。
{} 包裹。[] 包裹。對象:
var o = {
"xlid": "cxh",
"xldigitid": 123456,
"topscore": 2000,
"topplaytime": "2009-08-20"
};
陣列(值的他就是有序集合):
var jsonranklist = [
{ "xlid": "cxh", "xldigitid": 123456, "topscore": 2000, "topplaytime": "2009-08-20" },
{ "xlid": "zd", "xldigitid": 123456, "topscore": 1500, "topplaytime": "2009-11-20" }
];
在網路傳輸中,JSON 是以字符串形式傳遞的;而 JavaScript 內部操作的是對象。因此兩者的互相轉換是關鍵環節。先釐清兩者的外觀差異:
// JSON 字符串
var str1 = '{ "name": "cxh", "sex": "man" }';
// JSON 對象
var str2 = { "name": "cxh", "sex": "man" };
寫法一:JSON.parse()(標準做法)
var obj = JSON.parse(str);
alert(obj.name);
alert(obj.sex);
寫法二:eval()(不建議)
var obj = eval('(' + str + ')');
用括號包住是為了避免引擎把花括號誤認為區塊起始。eval 會執行字串中的任意程式碼,若資料來源不受信任就有程式碼注入風險,正式環境請一律改用 JSON.parse。
寫法三:舊版 json.js 提供的 parseJSON()
var obj = str.parseJSON();
這是早期 json.js 套件把方法掛到 String.prototype 上的寫法,如今已被標準淘汰,僅在維護老系統時會遇到。
一個容易踩的坑:如果 obj 本來就是對象,用 eval() 轉換(哪怕轉好幾次)通常還是可以得到對象,但用 parseJSON() 處理會丟出語法異常。判斷當前變數到底是字串還是對象,永遠是轉換前該做的第一件事。
標準做法:
var last = JSON.stringify(obj);
alert(last);
舊版寫法:
var last = obj.toJSONString();
JSON.stringify 支援第二、三個參數,實務上很實用:
// 第二個參數:控制哪些欄位要輸出
JSON.stringify(obj, ['name', 'sex']);
// 第三個參數:縮排美化,除數字外也可傳字符串
console.log(JSON.stringify(obj, null, 2));
早期需要另外下載 json.js(網址 https://www.json.org/json.js)才有這些方法。新版瀏覽器已把 JSON.stringify() 與 JSON.parse() 內建為標準物件方法,不再需要任何外部套件。若執行環境舊到沒有原生 JSON 物件,才需要引入 polyfill。原始碼中出現的 Object.toJSONString() 與 String.parseJSON() 是過渡時期的產物,新專案不必理會。
處理日期時,JSON.stringify 會呼叫 Date 的 toJSON 轉成 ISO 字符串;若後端要求特定格式,可在傳入前先自行格式化。另外若要處理 undefined、函數、Symbol 這類不合法的 JSON 值,它們在序列化時會被直接省略(陣列中則變為 null),這是規格行為而非 bug。