$.grep() 是 jQuery 提供的通用數組過濾工具,作用類似原生 Array.prototype.filter,但在需要兼容老舊瀏覽器的年代,或者想在 jQuery 鏈中直接處理普通數組時非常方便。
$.grep(array, callback [, invert])
三個參數的含義:array 是待過濾的數組;callback 是過濾條件,會對每個元素執行,參數為 (element, index);invert 可選,為 true 時保留「不通過」的元素,為 false 或不傳時保留「通過」的元素——也就是說,這個布爾值決定的是過濾結果要不要反轉。
挑出數組中大於 50 的元素:
var test = $.grep([1, 32, 5, 63, 8, 4, -8, -5, 2, 56, 9, 62, -6], function (n, i) {
if (n > 50) {
return n;
}
});
console.log(test); // ----> [63, 56, 62]
回調函數的返回值會被當作布爾值判斷,因此寫成 return n > 50; 更直觀。
// invert 為 true:保留不通過的元素
var a = $.grep([1, 32, 5, 63, 8, 4, -8, -5, 2, 56, 9, 62, -6], function (n) {
return n > 50;
}, true);
console.log(a); // ----> [1, 32, 5, 8, 4, -8, -5, 2, 9, -6]
// invert 為 false:行為與不傳相同
var b = $.grep([1, 32, 5, 63, 8, 4, -8, -5, 2, 56, 9, 62, -6], function (n) {
return n > 50;
}, false);
console.log(b); // ----> [63, 56, 62]
第一,返回值要真的 return。只寫 if (n > 50) { ... } 卻沒有 return,等於回傳 undefined,結果會是全空數組。
第二,它不改變原數組。$.grep 返回的是新數組,原數組保持不變,這與 $.map 的行為一致。
第三,與 filter 的取捨。在現代項目中,[1,2,3].filter(fn) 語法更短、性能也不遜色,是更推薦的寫法。$.grep 的價值主要體現在維護老項目,或者團隊統一使用 jQuery 工具函數風格時。
第四,注意它處理的是類數組。傳入 NodeList、jQuery 對象這類類數組時,$.grep 也能正常工作並返回真正的數組,這反而是它的一個便利之處。