.each() 是 jQuery 最基礎也最核心的工具方法之一。本文從源碼層面解析其兩種形態(靜態 $.each() 與實例 .each())的實現差異、參數傳遞機制、this 指向邏輯,並揭示常見誤區。
// 實例方法:委托給靜態方法
jQuery.prototype.each = function(fn, args) {
return jQuery.each(this, fn, args);
};
$.each(obj, fn, args):通用工具,遍歷任意對象/陣列$(selector).each(fn):遍歷 jQuery 對象內部的 DOM 元素集合jQuery.each = function(obj, fn, args) {
var i, length = obj.length;
// 情況 A:有額外參數 args
if (args) {
if (length === undefined) {
// 對象:遍歷所有鍵,每次調用 fn.apply(obj, args)
for (i in obj) {
if (fn.apply(obj, args) === false) break;
}
} else {
// 陣列:遍歷索引,每次調用 fn.apply(obj, args)
for (i = 0; i < length; i++) {
if (fn.apply(obj, args) === false) break;
}
}
}
// 情況 B:無額外參數
else {
if (length === undefined) {
// 對象:遍歷鍵,調用 fn.call(obj, key, obj[key])
for (i in obj) {
if (fn.call(obj, i, obj[i]) === false) break;
}
} else {
// 陣列:遍歷索引,調用 fn.call(value, index, value) —— 關鍵:this 指向值
for (i = 0, value = obj[0]; i < length && fn.call(value, i, value) !== false; value = obj[++i]) {}
}
}
return obj; // 返回原對象,支持鏈式
};
| 調用形式 | 回調簽名 | this 指向 | 中斷方式 |
|---|---|---|---|
$.each(arr, fn) |
fn(index, value) |
value (當前元素值) | 返回 false |
$.each(obj, fn) |
fn(key, value) |
obj (被遍歷對象) | 返回 false |
$.each(arr, fn, [args]) |
fn(...args) |
arr (陣列對象) | 返回 false |
$(sel).each(fn) |
fn(index, domElement) |
domElement (原生 DOM) | 返回 false |
false → 立即中斷循環(break)for...in 無法中斷)var obj = {a:1, b:2, c:3};
$.each(obj, function(k, v) {
if (k === 'b') return false; // 無效!繼續執行 c
console.log(k, v);
});
// 輸出: a 1, b 2, c 3
傳遞固定參數給回調,回調簽名變為 fn(...args),this 指向被遍歷對象:
$.each([1,2,3], function(a, b) {
console.log(this, a, b); // this=[1,2,3], a=10, b=20
}, [10, 20]);
// 錯誤預期:找到 b 就停止
$.each({a:1, b:2, c:3}, function(k, v) {
if (k === 'b') return false;
});
// 實際:繼續遍歷 c
// 正確:需自行控制
var stop = false;
$.each(obj, function(k, v) {
if (stop) return;
if (k === 'b') { stop = true; return; }
// ...
});
$.each([10,20,30], function(i, v) {
console.log(this); // 10, 20, 30 (值)
console.log(arguments); // [i, v]
// this === v 恒成立
});
var arr = [1,2,3,4,5];
$.each(arr, function(i, v) {
if (v === 3) arr.splice(i, 1); // 刪除當前項
});
// 結果:[1,2,4,5] —— 4 的索引變為 2,但循環繼續 i=3 訪問 5,跳過 4
// 解決:反向遍歷或收集索引後統一刪除
// 正確:this 是 DOM 元素
$('div').each(function() {
this.style.color = 'red'; // 或 $(this).css('color', 'red');
});
for 循環,避免函數調用開銷for...of (ES6) 或 Array.prototype.forEach$.each 仍是不錯選擇(原生 forEach 無法中斷)| 方法 | 中斷支持 | this 指向 | 適用對象 |
|---|---|---|---|
$.each(arr, fn) |
✅ | value | 陣列/對象/類數組 |
arr.forEach(fn) |
❌ | undefined/全局 | 陣列 |
for (let v of arr) |
✅ (break) | 無 | 可迭代對象 |
Object.keys(obj).forEach(fn) |
❌ | 無 | 對象自有鍵 |
$.each() 以「統一接口、靈活 this 指向、可中斷陣列遍歷」成為 jQuery 生態核心工具。深入理解其源碼機制(call/apply 切換上下文、對象不可中斷、args 參數改變簽名),能避開 90% 的坑。現代項目中,簡單遍歷優先原生語法,複雜控制流或需兼容舊環境時,$.each() 依然是可靠利器。