在思考如何設計一支 JavaScript API 時,方法鏈是個很值得研究的模式。它讓連續的運算寫成一行流暢的敘述,jQuery 是最廣為人知的實踐者。本文從定義、實際用法到自製實作逐一說明。
維基百科的說法是:方法鏈(又稱命名參數慣用法)是物件導向語言中連續呼叫多個方法的常見語法。每個方法都回傳一個物件,使這些呼叫能串接在同一個敘述裡。它本質上是語法糖,省去了中間變數。由於同一行裡串了愈來愈多方法,這個模式也被戲稱為「火車失事」(train wreck)——即使實際寫作時通常會加上換行讓它易讀一些。
// 方法鏈
$("#person").slideDown('slow')
.addClass('grouped')
.css('margin-left', '11px');
不用方法鏈時,得寫成這樣:
var p = $('#person');
p.slideDown('slow');
p.addClass('grouped');
p.css('margin-left', '11px');
差異不只是行數。鏈式寫法避免了重複執行同一個選擇器(jQuery 中選擇器查詢是效能瓶頸),也讓「這些操作作用在同一個對象上」這件事在視覺上更明確。它與設計模式中的 Builder 有幾分相似,不同的是這裡被串起來的是方法,而非一個獨立的建造者類別。
最直觀的嘗試是用閉包一層層回傳函式:
function f(i){
return function(e){
i += e;
return function(e){
i += e;
return function(e){
alert(i + e);
};
};
};
}
f(1)(2)(3)(4); // 10
問題很明顯:鏈有多長就得巢狀幾層,無法動態決定。另一種常見寫法是讓每個方法回傳一個帶著下一步方法的新物件:
var func = (function() {
return {
add: function () {
console.log('1');
return {
result: function () { console.log('2'); }
};
}
}
})();
func.add().result();
同樣的問題:每加一個步驟就要多包一層。
真正的做法是讓所有方法回傳它們所屬的物件本身,這樣就能無限串接:
Func = (function() {
this.add = function(){
console.log('1');
return this;
};
this.result = function(){
console.log('2');
return this;
};
return this;
});
var func = new Func();
func.add().result();
既然每步都回傳 this,最後兩行還可以壓縮成一行:
new Func().add().result();
這裡有個細節值得注意:new Func() 建立的物件在函式執行期間,this 就指向該物件,因此 this.add = ... 等於在物件上掛方法;而 IIFE 外層的 this 在非嚴格模式的全域環境中其實是 window,只是暫時被借用來收集方法,最後又被 return this 交回給 new 的結果。這個寫法能動,但語意不夠乾淨,實務上直接寫成類別或字面值會清楚得多:
const chain = {
value: 0,
add(n) { this.value += n; return this; },
multiply(n) { this.value *= n; return this; },
result() { return this.value; }
};
chain.add(5).multiply(3).add(1).result(); // 16
這個模式很方便,但有幾個要留意的地方。除錯變難:一行串了十幾個呼叫,出錯時堆疊追蹤雖仍能定位,但中斷點只能設在整行上。每個方法都必須回傳 this,一旦有人寫了個回傳 undefined 的方法,整條鏈就斷在那裡,而且錯誤訊息會指向下一個方法,造成誤導。不適合回傳多個值:需要回傳結果時,通常得另外提供 result() 這類終結方法,鏈的統一性就被打破了。
方法鏈(Method Chaining)與原型鏈(Prototype Chaining)名稱相似,常被混淆。兩者的共同點是都涉及「串接」,差別在於:原型鏈靠的是原型,是 JavaScript 用來實作屬性與方法查找繼承的機制,由語言本身提供;方法鏈靠的是方法回傳值,是一種由開發者刻意設計的 API 風格。前者解決「屬性去哪裡找」,後者解決「呼叫怎麼寫得順」,兩者可以同時存在——事實上 jQuery 就是靠原型鏈讓所有選到的元素共用 slideDown、addClass 等方法,再用回傳 this 把它們串成鏈。