$.each() 是 jQuery 裡最常被拿出來用的工具函式之一,可以同時處理陣列與物件,寫法比原生 for 迴圈乾淨。但它有一個很容易踩到的陷阱:傳進去的如果是「字串」而不是「物件」,就會直接爆掉。
var json = [
{ "id": "1", "tagName": "apple" },
{ "id": "2", "tagName": "orange" },
{ "id": "3", "tagName": "banana" },
{ "id": "4", "tagName": "watermelon" },
{ "id": "5", "tagName": "pineapple" }
];
$.each(json, function (idx, obj) {
alert(obj.tagName);
});
這段程式如預期依序提示 apple、orange……沒問題。回呼函式的第一個參數是索引(或物件的鍵),第二個是值。
如果資料來源是 Ajax 回傳的文字、或從後端直接寫入的常數,很可能拿到的是「一段字串」——即使內容看起來跟上面的陣列一模一樣:
var json = '[{"id":"1","tagName":"apple"},{"id":"2","tagName":"orange"},
{"id":"3","tagName":"banana"},{"id":"4","tagName":"watermelon"},
{"id":"5","tagName":"pineapple"}]';
$.each(json, function (idx, obj) {
alert(obj.tagName);
});
在 Chrome 主控台會看到:
Uncaught TypeError: Cannot use 'in' operator to search for '156'
in [{"id":"1","tagName":"apple"}...
原因很直接:$.each 對待字串時會把它當成「可索引的序列」逐字元處理,此時 obj 是一個字元而非物件,後續的屬性存取自然失敗。
用標準的 JSON.parse() 或 jQuery 提供的 $.parseJSON() 轉一次就好:
$.each(JSON.parse(json), function (idx, obj) {
alert(obj.tagName);
});
// 或者
$.each($.parseJSON(json), function (idx, obj) {
alert(obj.tagName);
});
讓 Ajax 幫你解析。在 $.ajax 裡指定 dataType: "json",成功回呼收到的就已經是物件,不必再手動 parse;用 $.getJSON() 更是預設就處理好。
不要用 eval。網路上還能看到用 eval() 解析 JSON 的寫法,這會讓任意字串被當成程式碼執行,是明確的安全風險,請一律改用 JSON.parse()。
順帶一提:若只想遍歷物件而不想用 jQuery,現代的 Object.keys(obj).forEach() 或 for...of 都是不錯的選擇,效能與語意都更清楚。