jQuery 提供豐富的數組/類數組工具方法,但現代 JavaScript (ES6+) 已原生提供功能更強、效能更好的替代。本文對比 $.each/$.grep/$.map/$.inArray/$.merge/$.uniqueSort/$.makeArray 與原生 API,給出遷移指南與兼容封裝。
| jQuery 方法 | 原生替代 (ES6+) | 說明 |
|---|---|---|
$.each(arr, fn) | arr.forEach(fn) / Object.entries(obj).forEach(([k,v])=>...) | 原生不支援中途 return false 終止,需用 for...of |
$.grep(arr, fn) | arr.filter(fn) | 語意一致,原生更快 |
$.map(arr, fn) | arr.map(fn).flat() | jQuery map 自動扁平化返回值,原生需手動 flat |
$.inArray(val, arr) | arr.indexOf(val) / arr.includes(val) | 返回索引/布爾,原生更語意化 |
$.merge(arr1, arr2) | [...arr1, ...arr2] 或 arr1.concat(arr2) | jQuery 修改第一個參數,原生不變更 |
$.uniqueSort(arr) | [...new Set(arr)] (基本類型) / arr.filter((v,i,a)=>a.indexOf(v)===i) | 原生去重更簡潔,jQuery 僅針對 DOM 元素去重 |
$.makeArray(obj) | Array.from(obj) / [...obj] | 類數組/可迭代對象轉真數組 |
// jQuery
$.each([1,2,3], (i, v) => { if (v===2) return false; console.log(v); }); // 可中斷
// 原生:需用 for...of 中斷
for (const v of [1,2,3]) { if (v===2) break; console.log(v); }
// 對象遍歷
$.each({a:1,b:2}, (k,v) => console.log(k,v));
Object.entries({a:1,b:2}).forEach(([k,v]) => console.log(k,v));
const nums = [1,2,3,4,5,6];
const gt3 = $.grep(nums, v => v > 3); // [4,5,6]
const gt3 = nums.filter(v => v > 3); // 同樣
const arr = [[1,2], [3,4]];
$.map(arr, v => v); // [1,2,3,4] 自動扁平化
arr.map(v => v).flat(); // [1,2,3,4]
arr.flatMap(v => v); // 一步到位
const arr = ['a','b','c'];
$.inArray('b', arr); // 1
arr.indexOf('b'); // 1
arr.includes('b'); // true (ES7)
const a = [1,2], b = [3,4];
$.merge(a, b); // a 變為 [1,2,3,4],返回 a
[...a, ...b]; // [1,2,3,4],不修改原數組
a.concat(b); // 同上
const arr = [3,1,2,3,2,1];
$.uniqueSort(arr); // [1,2,3] (排序後去重,僅 DOM 元素保證順序)
[...new Set(arr)]; // [3,1,2] 保持首次出現順序
arr.filter((v,i,a) => a.indexOf(v) === i); // [3,1,2] 兼容 IE
const nodes = document.querySelectorAll('div');
$.makeArray(nodes); // [div, div, ...]
Array.from(nodes); // 同上
[...nodes]; // 同上
const _ = {
each: (coll, fn) => {
if (Array.isArray(coll)) coll.forEach(fn);
else Object.entries(coll).forEach(([k,v]) => fn(k,v));
},
grep: (arr, fn) => arr.filter(fn),
map: (arr, fn) => arr.flatMap(fn),
inArray: (val, arr) => arr.indexOf(val),
merge: (a, b) => [...a, ...b],
unique: (arr) => [...new Set(arr)],
makeArray: (obj) => Array.from(obj)
};
$els.map(fn) 返回 jQuery 對象,鏈式調用方便。$.uniqueSort($els) 正確處理元素節點比較。