我們日常寫 jQuery 時,幾乎不會直接動手呼叫 pushStack()。但一旦你要開發涉及 DOM 遍歷的外掛,它就變得非常關鍵。
在 jQuery 內部,pushStack() 會透過改變 jQuery 物件上的 prevObject 屬性,來「記錄」鏈式呼叫中上一個方法所回傳的 DOM 結果集。之所以說是記錄而非複製,是因為實際存下來的是一個引用,而該結果集同樣已被包裝成 jQuery 物件。當鏈條上接著呼叫 end() 時,內部做的事就是把當前物件的 prevObject 交還給你。
更深的細節直接翻原始碼即可,這裡用一個最小例子把關係講清楚。
HTML 結構:
<div id="grandparent"> I am grandparent. <div id="parent"> I am parent. <div id="child"> I am child. </div> </div> </div>
JavaScript:
var els = $('#child').parent().parent();
console.dir(els);

既然連續兩次 parent() 有點囉嗦,我們封裝成 .grandparent()。如果一時沒想到 end() 這件事,直覺寫法大概是:
$.fn.grandparent = function() {
return this.parent().parent();
};
接著沿用上面的例子:
$('#child').grandparent().end(); //jQuery-[div#parent]
結果顯然不是我們想要的。多數情況下,我們期待 end() 能一路退回最初的 jquery[div#child],而它卻停在了 div#parent——因為鏈條上的「上一站」紀錄被原生方法覆蓋掉了。
修正方式只需加上一行:
$.fn.grandparent = function() {
var els = this.parent().parent();
return this.pushStack(els.get());
};
在 pushStack() 內部,傳入的 els.get()(一個 DOM 陣列)會被包裝成全新的 jQuery 物件,而原本的 this(也就是 jQuery[div#child])會被賦值給這個新物件的 prevObject,最後回傳新物件。
於是 end() 的行為就正確了:
var grandparent = $('#child').grandparent() /* jquery-[div#grandparent]*/
.end() /* jquery-[div#child] */
這正是自製遍歷型外掛時容易被忽略的一環:只要你的外掛內部做了 DOM 遍歷,就該用 pushStack() 把結果交出去,鏈式呼叫與 end() 的語意才能保持完整。
本文核心思路整理自 Learning jQuery 上的相關文章,感謝原作者分享。