在原生 JSON 物件尚未普及的年代,json2.js 是每個專案必備的 polyfill。它的用法本身很簡單,真正的重點在於理解「JSON 文字」與「JavaScript 物件」是兩回事。
<script type="text/javascript" src="json2.js"></script>
<script>
// 直接宣告 JSON 資料結構(這其實就是普通的 JS 物件字面值)
var myJSONObject = {"bindings": [
{"ircEvent": "PRIVMSG", "method": "newURI", "regex": "^https://.*"},
{"ircEvent": "PRIVMSG", "method": "deleteURI", "regex": "^delete.*"},
{"ircEvent": "PRIVMSG", "method": "randomURI", "regex": "^random.*"}
]};
// 對比一下:普通字串 vs 合法 JSON 文字
var normalstring = '[{persons:[{name:"jordan",sex:"m",age:"40"},
{name:"bryant",sex:"m",age:"28"},
{name:"McGrady",sex:"m",age:"27"} ]}]';
var jsontext = '[{"persons":[{"name":"jordan","sex":"m","age":"40"},
{"name":"bryant","sex":"m","age":"28"},
{"name":"McGrady","sex":"m","age":"27"} ]}]';
// 用 eval 轉為物件(不建議,見下方說明)
var myE = eval(normalstring);
document.writeln(myE + '<br><br>');
// 物件 → JSON 文字
var text = JSON.stringify(myE);
document.writeln('轉換後的json文本:' + text + '<br><br>');
// 文字 → 物件
var myData = JSON.parse(jsontext);
document.writeln(myData + '<br><br>');
</script>
從範例不難看出兩段字串的差異:normalstring 的屬性名稱沒有加引號,這在嚴格的 JSON 規範中是不合法的;jsontext 才是標準格式。eval 勉強能吃掉前者,但這正是風險所在。
eval 會執行字串中的任何程式碼,只要資料來源有可能被污染,就是一個 XSS 入口。JSON.parse 只辨識 JSON 文字、更安全,凡是安全考量重要的場合都應該使用它。
var jsonObj2 = {persons: [
{name:"jordan", sex:"m", age:"40"},
{name:"bryant", sex:"m", age:"28"},
{name:"McGrady", sex:"m", age:"27"}
]};
var persons = jsonObj2.persons;
var str = "";
var person = {name:"yaoMing", sex:"m", age:"26"};
// 適用於陣列的方法都能用在這裡
// jsonObj2.persons.push(person); // 尾端新增一筆
// jsonObj2.persons.pop(); // 刪除最後一項
// jsonObj2.persons.shift(); // 刪除第一項
jsonObj2.persons.unshift(person); // 前端新增一筆
// splice 是萬用工具,可同時完成刪除與插入
var self = {name:"tom", sex:"m", age:"24"};
var brother = {name:"Mike", sex:"m", age:"29"};
// jsonObj2.persons.splice(0, 2); // 刪除:起始位置, 刪除個數
jsonObj2.persons.splice(1, 0, self, brother); // 插入:起始位置, 刪除個數, 要插入的物件
for (var i = 0; i < persons.length; i++) {
var cur_person = persons[i];
str += cur_person.name + "'sex is " + cur_person.sex
+ " and age is " + cur_person.age + "<br><br>";
}
document.writeln(str);
// 最後再轉回 JSON 文字
var myjsonobj = JSON.stringify(jsonObj2);
document.writeln(myjsonobj);
</script>
關鍵觀念是:JSON 物件裡的陣列就是普通的 JavaScript 陣列,所以 push、pop、shift、unshift、splice 全部可用。splice 尤其強大,靠「起始位置、刪除個數、插入內容」三個參數就能同時表達刪除、取代與插入三種操作。
現代瀏覽器早已原生支援 JSON.parse 與 JSON.stringify,不需要再引入 json2.js。另外請注意 JSON.stringify 的第二、三個參數( replacer 與 space)可以做到過濾欄位與美化縮排,是很實用但常被忽略的功能。