萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 數組工具方法全解析:each、grep、map、inArray、merge、unique、makeArray

jQuery 提供了一套強大的數組/類數組工具方法,彌補了原生 JS 陣列 API 的不足(特別是 ES5 之前)。本文系統梳理 7 個核心方法,附帶實戰示例與性能建議。

1. $.each(array, callback) — 通用遍歷

遍歷陣列或對象,回調參數:(index, value)。返回 false 可中斷循環(類似 break)。

var arr = ['javascript', 'php', 'java', 'c++', 'c#'];
$.each(arr, function(key, val) {
    console.log('index: ' + key + ', value: ' + val);
    // if (val === 'java') return false; // 中斷
});

優勢:統一處理陣列/對象/類數組;回調內 this 指向當前值(因使用 fn.call(val, i, val))。

2. $.grep(array, callback, [invert]) — 過濾篩選

返回新陣列,包含使回調返回 true 的元素。invert=true 時取反。

var arr = ['javascript', 'php', 'java', 'c++', 'c#', 'vb'];
// 保留包含 'c' 的元素
var filtered = $.grep(arr, function(val, key) {
    return val.indexOf('c') !== -1;
}, false); // ['c++', 'c#']

// invert=true:保留不包含 'c' 的
var filteredNot = $.grep(arr, function(val) {
    return val.indexOf('c') !== -1;
}, true); // ['javascript', 'php', 'java', 'vb']

回調參數順序:(value, index) —— 與 .each() 不同,注意區分。

3. $.map(array, callback) — 映射轉換

將每個元素通過回調轉換,返回新陣列。回調可返回:

  • 單值 → 對應位置替換
  • null → 刪除該項
  • 陣列 → 展開合併到結果
var arr = ['a', 'b', 'c', 'd'];

// 1. 統一添加後綴
$.map(arr, function(val) { return val + '_new'; }); // ['a_new', 'b_new', 'c_new', 'd_new']

// 2. 條件修改
$.map(arr, function(val) { return val === 'b' ? '[B]' + val : val; }); // ['a', '[B]b', 'c', 'd']

// 3. 擴展:每個元素生成兩個
$.map(arr, function(val) { return [val, val + '_copy']; }); // ['a', 'a_copy', 'b', 'b_copy', ...]

// 4. 刪除特定項
$.map(arr, function(val) { return val === 'c' ? null : val; }); // ['a', 'b', 'd']

jQuery 1.6+ 還支持對象映射:$.map({k1:'v1', k2:'v2'}, fn)。

4. $.inArray(value, array) — 判斷值是否存在

返回索引(≥0)或 -1(不存在)。類似 Array.indexOf 但兼容舊瀏覽器。

var fruits = ['蘋果', '香蕉', '橙子'];
$.inArray('香蕉', fruits); // 1
$.inArray('榴蓮', fruits); // -1

// 實戰:去重判斷
if ($.inArray(newVal, uniqueArr) === -1) {
    uniqueArr.push(newVal);
}

5. $.merge(first, second) — 合併陣列

將 second 追加到 first 並返回 first(修改原陣列)。

var front = ['js', 'css'];
var back  = ['php', 'java'];
$.merge(front, back); // front 變為 ['js', 'css', 'php', 'java']

// 避免修改原陣列:
var merged = $.merge($.merge([], front), back);

注意:僅合併兩個陣列,不如原生 concat 靈活(可合併多個、不修改原陣列)。

6. $.unique(array) — 去重(僅限 DOM 元素)

重要限制:只能去重 DOM 元素陣列,對字符串/數字陣列無效。

var divs = $('div').get();           // 獲取原生 DOM 陣列
divs = divs.concat($('div.dup').get()); // 人為製造重複
console.log(divs.length);            // 原始長度
divs = $.unique(divs);               // 去重
console.log(divs.length);            // 去重後長度

內部利用 sort + 節點比較 實現,適用於去重選擇器結果。

7. $.makeArray(obj) — 類數組轉真數組

將擁有 length 屬性、索引 0~length-1 的對象(如 NodeList、arguments)轉為真正陣列。

var h2List = document.getElementsByTagName('h2'); // HTMLCollection
var arr = $.makeArray(h2List);
console.log(arr.constructor.name); // "Array"
console.log(arr.slice(1));         // 可用陣列方法

現代瀏覽器可用 Array.from() 或 [...obj] 替代。

對比總結表

方法 用途 修改原陣列 返回值 常用度
$.each 遍歷/側效果 否 原陣列/對象 ⭐⭐⭐⭐⭐
$.grep 過濾 否 新陣列 ⭐⭐⭐⭐
$.map 映射/轉換/擴展 否 新陣列 ⭐⭐⭐
$.inArray 存在性/索引查詢 否 Number ⭐⭐⭐⭐
$.merge 合併 是 第一個陣列 ⭐⭐
$.unique DOM去重 否 新陣列 ⭐
$.makeArray 類數組轉陣列 否 新陣列 ⭐⭐

最佳實踐建議

  • 現代項目優先使用原生 ES5/ES6 陣列方法(forEach、filter、map、includes、concat、Array.from)
  • 需兼容 IE8 或操作 jQuery 選擇器結果時,使用 jQuery 工具方法
  • $.grep 回調參數順序 (value, index) 易混淆,寫註釋
  • $.unique 僅用於 DOM 去重,切勿用於數據陣列
  • 大量數據操作時,$.map 返回陣列展開特性可替代雙層循環
copyright © 萬盛學電腦網 all rights reserved