each 是 jQuery 最常用的迭代工具,但很多人寫完才發現「我 return 的東西呢?」本文把行為規則與取值方式講清楚。
return false; —— 停止整個循環,等同普通迴圈的 break。return true; —— 跳到下一筆,等同 continue。原因在於 jQuery 採用鏈式設計,$(...).each() 的返回值固定是原物件集合,而 each(function(){}) 裡的 function 是一個回呼函數,在回呼裡 return 的結果不會跑到外層作用域。
所以下面這種寫法是行不通的:
var result = $(".item").each(function(){
return $(this).text(); // 這個值不會傳到外面
});
function test(){
var success = false;
$(..).each(function () {
if (..) {
success = true;
return false; // 找到即中止
}
});
return success;
}
需要帶出多筆資料時,就宣告一個陣列在外層,在回呼裡 push:
var collected = [];
$(".item").each(function(){
collected.push($(this).val());
});
console.log(collected);
如果目的只是「取出值組合成新集合」,.map() 會比 each 更貼切,它天生就是為了回傳值而設計的:
var values = $(".item").map(function(){ return $(this).val(); }).get();
若是「找到符合條件的就停」,也可以考慮 $.each 搭配全域函式寫法,或直接用原生的 Array.prototype.find/some,語意更清楚,效能也更好。