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。