萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> 網頁設計

jQuery 參數強制轉數組技巧:解決 $.each 單元素遍歷失效問題

$.each 陷阱:當參數只有一個時

jQuery $.each() 期望接收陣列或類陣列對象。當傳入單一純值(數字、字符串、對象)而非陣列時,遍歷會失效或產生非預期結果。

問題重現

var pp = 3;           // 單一數值
var a = [pp];         // 手動包裝為陣列

alert(a);             // 輸出: 3

// 錯誤用法:直接遍歷純值
$.each(pp, function(i, n) {
  alert(i);           // 不會執行!pp 不是可遍歷對象
});

// 正確用法:遍歷陣列
$.each(a, function(i, n) {
  alert(i);           // 輸出: 0 (索引)
  alert(n);           // 輸出: 3 (值)
});

核心解決方案:中括號包裝法

// 通用包裝函數
function toArray(obj) {
  return Array.isArray(obj) ? obj : [obj];
}

// 使用
var param = getParam();  // 可能是單值、陣列、jQuery 對象、DOM 節點列表
$.each(toArray(param), function(i, val) {
  // 安全遍歷
});

進階場景:類陣列對象轉真陣列

對於 arguments、NodeList、HTMLCollection、jQuery 對象等類陣列:

// ES6 方式(推薦)
const realArray = Array.from(arrayLike);

// ES5 方式
const realArray = Array.prototype.slice.call(arrayLike);

// jQuery 內建方法
const realArray = $.makeArray(arrayLike);

最佳實踐總結

輸入類型 $.each 直接用? 推薦處理
陣列 []✅直接使用
單一值 (Number/String/Object)❌[val] 包裝
jQuery 對象 $()✅直接使用(內部已處理)
DOM NodeList⚠️$.makeArray() 轉換
arguments❌Array.from() 或 $.makeArray()

防禦性編程原則:在不確定輸入類型的工具函數入口,統一使用 Array.isArray() 判斷並按需包裝,消除「單元素不遍歷」這類隱性 Bug。

copyright © 萬盛學電腦網 all rights reserved