萬盛學電腦網

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

jQuery 遍歷陣列與物件完整指南:$.each() 與現代原生替代方案

jQuery $.each() 遍歷陣列/物件完整解析與現代 ES6+ 替代方案

$.each() 是 jQuery 核心遍歷工具,但現代 JavaScript 提供更強大、無依賴的原生替代方案。本文詳細比較各種遍歷方式的語法、效能、適用場景與最佳實踐。

jQuery $.each() 基礎語法


// 陣列遍歷
var members = ['1', '2', '3'];
$.each(members, function(index, value) {
  console.log(index, value); // 0 "1", 1 "2", 2 "3"
  // return false 可中斷迴圈 (相當於 break)
  // return true 可跳過本次 (相當於 continue)
});

// 物件遍歷
var user = { name: 'John', age: 30, city: 'Taipei' };
$.each(user, function(key, value) {
  console.log(key, value); // name "John", age 30, city "Taipei"
});

// DOM 元素遍歷
$('li').each(function(index, element) {
  console.log(index, element.textContent);
  // this === element (原生 DOM)
});

關鍵特性與注意事項

  • 回呼參數順序固定:(index, value) - 陣列是索引,物件是鍵名
  • this 綁定:回呼內 this 指向當前值 (原始值會被包裝為物件)
  • 中斷控制:return false = break,return true = continue
  • 不可變性:$.each 不會修改原陣列/物件,但回呼內修改 value 參數不影響原資料
  • 類陣列物件支援:arguments、NodeList、jQuery 物件皆可遍歷

現代原生替代方案完整對照 (ES6+)

陣列遍歷

需求$.each()原生替代優勢
單純遍歷副作用$.each(arr, fn)arr.forEach(fn)原生、無依賴、效能佳
需索引function(i, v)function(v, i, arr)參數順序更直覺 (值優先)
需中斷return falsefor...of + break標準控制流
映射新陣列$.map(arr, fn)arr.map(fn)函數式、不可變
過濾$.grep(arr, fn)arr.filter(fn)標準、可鏈式
查找單一$.each + breakarr.find(fn)語意明確、短路
查找索引$.each + breakarr.findIndex(fn)語意明確
累積/歸約$.each + 變數arr.reduce(fn, init)函數式核心
檢測全部/任一$.each + 旗標arr.every(fn) / arr.some(fn)短路、語意化

物件遍歷


const user = { name: 'John', age: 30, city: 'Taipei' };

// 1. Object.keys() + forEach (最常用)
Object.keys(user).forEach(key => {
  console.log(key, user[key]);
});

// 2. Object.entries() + forEach (同時拿 key/value)
Object.entries(user).forEach(([key, value]) => {
  console.log(key, value);
});

// 3. for...in (含繼承屬性,需配合 hasOwnProperty)
for (const key in user) {
  if (Object.prototype.hasOwnProperty.call(user, key)) {
    console.log(key, user[key]);
  }
}

// 4. Object.getOwnPropertyNames() (含不可枚舉屬性)
Object.getOwnPropertyNames(user).forEach(key => { ... });

效能基準測試 (10萬元素陣列)


const arr = new Array(100000).fill(0).map((_, i) => i);
const iterations = 100;

console.time('$.each');
for (let t = 0; t < iterations; t++) $.each(arr, (i, v) => v * 2);
console.timeEnd('$.each');        // ~450ms

console.time('forEach');
for (let t = 0; t < iterations; t++) arr.forEach(v => v * 2);
console.timeEnd('forEach');       // ~180ms

console.time('for...of');
for (let t = 0; t < iterations; t++) { for (const v of arr) v * 2; }
console.timeEnd('for...of');      // ~150ms

console.time('for loop');
for (let t = 0; t < iterations; t++) { for (let i=0; i v * 2);
console.timeEnd('map');           // ~220ms (含新陣列分配)

進階場景:jQuery 物件遍歷最佳實踐


// ❌ 避免:在 each 中重複建立 jQuery 物件
$('.items').each(function() {
  var $this = $(this); // 每次都包裝
  $this.find('.title').text('...');
});

// ✅ 推薦:使用原生 DOM 或快取
$('.items').each(function() {
  // this 是原生 DOM
  this.querySelector('.title').textContent = '...';
});

// ✅ 或使用 jQuery 內建方法鏈式操作 (無需 each)
$('.items .title').text('...'); // 批次設定
$('.items').addClass('processed'); // 批次加類別

// ✅ 需要逐個邏輯時:使用 .get() 取得原生陣列
$('.items').get().forEach(el => {
  // 原生 DOM 操作
  el.classList.add('processed');
});

TypeScript 型別安全遍歷


// 陣列
const numbers: number[] = [1, 2, 3];
numbers.forEach((value, index, array) => { /* ... */ });
for (const value of numbers) { /* ... */ }

// 物件 (Record)
const user: Record = { name: 'John', age: 30 };
Object.entries(user).forEach(([key, value]) => { /* ... */ });

// 介面限制
interface User { name: string; age: number; }
const user: User = { name: 'John', age: 30 };
(Object.keys(user) as Array).forEach(key => {
  const value = user[key]; // 型別安全
});

遷移檢查清單

  • [ ] 將 `$.each(arr, fn)` → `arr.forEach(fn)`
  • [ ] 將 `$.each(obj, fn)` → `Object.entries(obj).forEach(([k,v]) => fn(k,v))`
  • [ ] 將 `$.map(arr, fn)` → `arr.map(fn)`
  • [ ] 將 `$.grep(arr, fn)` → `arr.filter(fn)`
  • [ ] 將 `$.inArray(val, arr)` → `arr.indexOf(val)` / `arr.includes(val)`
  • [ ] 將 `$.extend({}, obj1, obj2)` → `{...obj1, ...obj2}`
  • [ ] 移除 jQuery 依賴後執行完整測試套件
copyright © 萬盛學電腦網 all rights reserved