在 JavaScript 裡傳遞結構化資料,幾乎一定會碰到「字串變物件」與「物件變字串」這兩個動作。早期要自己引入 JSON2.js,現在主流瀏覽器都內建了,但理解兩者的關係仍然有用——尤其是在維護老系統的時候。
// 字串 → 物件(解析)
var obj = JSON.parse('{"name":"tom","sex":"男","age":"24"}');
// 物件 → 字串(序列化)
var str = JSON.stringify({ name: "tom", sex: "男", age: "24" });
如果系統裡有 JSON2.js,對應的呼叫是把 JSON 換成 JSON2:
var b = JSON2.parse(a); // 字串 a 轉為物件
var c = JSON2.stringify(b); // 物件 b 轉回字串
JSON2.js 的實作方式是:先檢查全域有沒有 JSON 物件,沒有的話才建立自己的實作。所以在現代瀏覽器裡引入它不會覆蓋原生版本,只是多下一個檔而已。這也是它當年能被廣泛使用的原因。
<script src="jquery.min.js" type="text/javascript"></script>
<script src="json2.js" type="text/javascript"></script>
<script type="text/javascript">
var a = '{ "name": "tom", "sex": "男", "age": "24" }';
alert("原始字串:" + a);
var b = JSON.parse(a); // 轉為物件
alert("name 欄位:" + b.name); // tom
var c = JSON.stringify(b); // 轉回字串
alert("轉換後:" + c);
</script>
這是最常見的 bug 來源。下面這段看起來正常,實際上 b 只是一個字串,b.name 是 undefined:
var b = '{ "name": "tom" }'; // 少了 JSON.parse()
alert(b.name); // undefined
另一個方向相反的錯誤出現在 JSON.stringify() 已經收到字串時——它會把整串再包一層引號並轉義,得到 "{ \"name\": \"tom\" }" 這種結果。
// 第二個參數:控制哪些欄位要輸出
JSON.stringify(obj, ["name", "age"]);
// 第三個參數:縮排,讓輸出可讀
JSON.stringify(obj, null, 2);
第二個參數也可以傳函式,用來在序列化過程中過濾或改寫值,例如把 Date 轉成自訂格式。第三個參數傳數字是空格數,傳字串則用該字串縮排。
JSON 格式本身沒有日期型別,所以 JSON.parse() 出來的日期一定是字串。要還原成 Date 物件,用 reviver:
var data = JSON.parse(text, function (key, value) {
if (typeof value === 'string' &&
/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) {
return new Date(value);
}
return value;
});
早期一些教學會寫 eval("(" + text + ")") 來解析 JSON。這在資料來源不可信時等於直接執行任意程式碼。JSON.parse() 只會解析、不會執行,而且更快。沒有任何理由在新程式碼裡用 eval 做這件事。