萬盛學電腦網

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

jQuery each() 方法深度解析:源碼實現、參數細節與實戰陷阱

.each() 是 jQuery 最基礎也最核心的工具方法之一。本文從源碼層面解析其兩種形態(靜態 $.each() 與實例 .each())的實現差異、參數傳遞機制、this 指向邏輯,並揭示常見誤區。

一、兩種 each 的關係

// 實例方法:委托給靜態方法
jQuery.prototype.each = function(fn, args) {
    return jQuery.each(this, fn, args);
};
  • $.each(obj, fn, args):通用工具,遍歷任意對象/陣列
  • $(selector).each(fn):遍歷 jQuery 對象內部的 DOM 元素集合

二、$.each 核心源碼邏輯(簡化版)

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; // 返回原對象,支持鏈式
};

三、關鍵細節解析

1. 回調參數與 this 指向

調用形式 回調簽名 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

2. 陣列 vs 對象的中斷行為差異

  • 陣列:回調返回 false → 立即中斷循環(break)
  • 對象:無視返回值,必定遍歷所有可枚舉屬性(ES5 規範 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

3. args 參數的作用

傳遞固定參數給回調,回調簽名變為 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]);

四、實戰陷阱與避坑指南

陷阱 1:誤以為對象遍歷可中斷

// 錯誤預期:找到 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; }
    // ...
});

陷阱 2:陣列回調中 this 不是索引

$.each([10,20,30], function(i, v) {
    console.log(this);     // 10, 20, 30 (值)
    console.log(arguments); // [i, v]
    // this === v 恒成立
});

陷阱 3:修改陣列長度導致索引錯亂

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
// 解決:反向遍歷或收集索引後統一刪除

陷阱 4:DOM 集合遍歷修改樣式

// 正確:this 是 DOM 元素
$('div').each(function() {
    this.style.color = 'red'; // 或 $(this).css('color', 'red');
});

五、性能優化建議

  1. 大量數據(>1000項)優先用原生 for 循環,避免函數調用開銷
  2. 頻繁調用的回調提取為命名函數,避免重複創建匿名函數
  3. 只讀遍歷用 for...of (ES6) 或 Array.prototype.forEach
  4. 需要中斷的陣列遍歷,$.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() 依然是可靠利器。

copyright © 萬盛學電腦網 all rights reserved