$.each(collection, function(index, value) {
// this === value (原始值會被包裝成 Object)
// 返回 false → 終止迴圈 (break)
// 返回 true → 跳過本次 (continue)
});
const arr = ['one', 'two', 'three'];
$.each(arr, (i, val) => console.log(i, val));
// 0 "one"
// 1 "two"
// 2 "three"
const obj = { a: 1, b: 2, c: 3 };
$.each(obj, (key, val) => console.log(key, val));
// "a" 1
// "b" 2
// "c" 3
$.each(document.querySelectorAll('li'), (i, el) => {
console.log(i, el.textContent);
// this === el (HTMLLIElement)
});
$('.item').each((i, el) => {
// 等價於 $('.item').each(fn)
// this === el (原生 DOM)
$(el).addClass(`item-${i}`);
});
const matrix = [[1,2,3], [4,5,6], [7,8,9]];
$.each(matrix, (rowIdx, row) => {
$.each(row, (colIdx, val) => {
console.log(`[${rowIdx},${colIdx}] = ${val}`);
});
});
// 輸出 [0,0]=1 [0,1]=2 ... [2,2]=9
$.each([1,2,3,4,5], (i, v) => {
if (v === 3) return false; // break 整個迴圈
if (v % 2 === 0) return true; // continue 跳過偶數
console.log(v); // 只印 1
});
| 場景 | 推薦寫法 | 理由 |
|---|---|---|
| 陣列遍歷 | `arr.forEach(fn)` / `for...of` | 原生、無函數調用開銷、支援 `break`/`continue` (for...of) |
| 物件遍歷 | `Object.entries(obj).forEach(([k,v])=>...)` | 標準、可解構、TypeScript 友善 |
| DOM 節點列表 | `[...nodes].forEach(fn)` 或 `Array.from(nodes).forEach(fn)` | 轉真陣列後用原生方法 |
| jQuery 物件 | `$els.each(fn)` (實例方法) | 內部優化、鏈式調用、語意明確 |
| 需中途終止 | `for...of` + `break` | `.each` 返回 `false` 語意不直觀 |
// $.each 類型定義 (DefinitelyTyped)
interface JQueryStatic {
each(collection: T[], callback: (index: number, value: T) => boolean | void): T[];
each(collection: Record, callback: (key: string, value: T) => boolean | void): Record;
each(collection: ArrayLike, callback: (index: number, value: T) => boolean | void): ArrayLike;
}
`.each()` 是 jQuery 時代統一遍歷介面的產物。現代開發**陣列用 `forEach`/`for...of`、物件用 `Object.entries`、DOM 列表用 `Array.from`**,只有在 **jQuery 物件鏈式調用中** 才繼續用 `$().each()`。理解「回傳 `false` = break、`true` = continue」特殊語意,維護舊代碼時不會踩坑。