處理 JSON 資料時,「複製一份來改」「從陣列裡挑出符合條件的」「依某個欄位排序」這三件事幾乎必然會遇到。JavaScript 原生沒有提供好用的工具,但 jQuery 剛好都有對應的方法。這篇把四個常用手法整理在一起。
$.map(json, function (n) { return n; });
用來複製陣列沒問題,但這個寫法有個陷阱:jQuery 的 $.map 在回呼回傳 null 或 undefined 時會把該項過濾掉,而且它是逐層展開的。用它去複製「陣列中的某一筆物件」,很容易出現欄位名稱遺失或結構被攤平的情況。單純複製陣列可以,複製物件請用下面的方法。
// 淺層複製:只複製最頂層的屬性
var newObject = jQuery.extend({}, oldObject);
// 深層複製:遞迴往下複製到最底層
var newObject = jQuery.extend(true, {}, oldObject);
差別在於第一個參數的 true。淺複製時,若屬性值是物件或陣列,複製出來的新物件和舊物件指向同一份記憶體,改新的會連舊的一起改。深複製會真的建立新的子物件,互不影響。
實務上的選擇很明確:只有平面資料(字串、數字組成的物件)用淺複製;只要巢狀一層以上,就用深複製,否則遲早遇到「我只是改副本,怎麼會影響到原資料」的 bug。要注意深複製不會複製函式與 DOM 節點,遇到 Date 等特殊型別也可能不如預期。
$.grep(jsonTmp, function (item) {
return item.LegendTitle == field;
}, false);
回呼回傳 true 的項目會被保留。第三個參數是 invert,給 false 表示「保留回傳 true 的」,給 true 則反過來變成排除。預設值是 false,所以這個參數通常可以省略。
若你面向的是現代瀏覽器,直接用原生的 arr.filter() 語意更清楚、效能也更好,jQuery 版本的主要價值在於舊環境的相容性。
json2.sort(function (a, b) {
return a["requiredColumn"]["crimeTime"] > b["requiredColumn"]["crimeTime"] ? 1 : -1;
});
sort 是原生陣列方法,你只要給它一個比較函式:a 應該排在 b 前面就回負值,後面就回正值。上面的寫法比較直覺,但更完整的版本會在兩值相等時回 0:
json2.sort(function (a, b) {
var t1 = a.requiredColumn.crimeTime;
var t2 = b.requiredColumn.crimeTime;
if (t1 < t2) return -1;
if (t1 > t2) return 1;
return 0;
});
補上 0 之後排序才是穩定的(stable sort),相等元素的相對順序不會被任意打亂。另外提醒一個常被忽略的細節:sort() 是原地排序,會直接改動原陣列。若想保留原資料,先 slice() 複製一份再排。
如果不是被舊專案綁住,這四件事在 ES5 之後都有原生對應:複製用 Object.assign() 或展開語法、深複製用 structuredClone()、過濾用 filter()、映射用 map()。理解背後的原理之後,換用哪一套語法都不成問題。