回調函數大概是 JavaScript 裡最常被使用、卻也最容易被當成「魔法」看待的語法。一行 jQuery 或一段 forEach 裡那個沒有名字的 function,背後其實有清楚可循的規則。本文從頭梳理:回調是什麼、怎麼運作、實作時該守哪些原則,以及層層嵌套時會遇到的「回調地獄」。
在 JavaScript 中,function 是內建的類物件,也就是說它是一種物件,和 String、Array、Number、Object 一樣。既然本質是物件,它就能存進變量、當成參數傳給另一個函數、在函數內部建立,甚至作為函數的回傳值。
這正是回調的基礎。回調來自一個著名的程式設計典範——函數式程式設計,其核心思想之一就是把函數當值來傳遞。這項技術過去常被歸類為艱澀的主題,但實際上它的用法單純得就像傳遞一個普通變量。
回調函數是一種高階函數:作為參數傳給另一個函數(以下稱 otherFunction),並在 otherFunction 內部被呼叫。由於它本質上是一種解決常見問題的模式,也被稱為「回調模式」。
最常見的例子莫過於 jQuery 的事件綁定:
// 傳給 click 參數的是一個函數,而不是變量
$("#btn_1").click(function () {
alert("Btn 1 Clicked");
});
這裡我們把函數當成 click 方法的參數傳入,click 會在內部呼叫它。原生 API 也是同樣的道理:
var friends = ["Mike", "Stacy", "Andy", "Rick"];
friends.forEach(function (eachName, index) {
console.log(index + 1 + ". " + eachName);
// 1. Mike, 2. Stacy, 3. Andy, 4. Rick
});
當我們把回調函數當參數傳給另一個函數時,傳過去的是函數的定義,而不是它的執行結果。等到包含函數拿到這個定義之後,就能在自己的函數體內任何位置呼叫它。
也就是說,回調並不是立即執行,而是在包含函數內指定的時機被「回」去呼叫——這正是回調名稱的由來。上面那個 jQuery 例子裡的匿名函數,實際上會延遲到 click 的函數體內才被執行,即使沒有名字,包含函數仍能透過 arguments 物件存取到它。
由於回調是在包含函數的函數體內被執行,效果等同於「在包含函數裡定義」,因此它是閉包。閉包能存取包含函數的作用域,所以回調函數可以讀取包含函數的區域變量,甚至全域變量。
前面兩個例子用的是匿名函數,另一種常見做法是定義具名函數、再把函數名稱當參數傳入:
// 全域變量
var allUserData = [];
// 通用的輸出函數
function logStuff(userData) {
if (typeof userData === "string") {
console.log(userData);
} else if (typeof userData === "object") {
for (var item in userData) {
console.log(item + ": " + userData[item]);
}
}
}
// 接受兩個參數,最後一個是回調函數
function getInput(options, callback) {
allUserData.push(options);
callback(options);
}
// 把 logStuff 當參數傳進去,它就會在 getInput 內被呼叫
getInput({name: "Rich", speciality: "JavaScript"}, logStuff);
// name: Rich
// speciality: JavaScript
回調執行時就跟一般函數一樣,可以接收參數。包含函數的任何屬性、區域變量或全域變量都能傳進去:
var generalLastName = "Clinton";
function getInput(options, callback) {
allUserData.push(options);
// 把全域變量也一起傳給回調
callback(generalLastName, options);
}
在呼叫之前檢查傳進來的東西是否為函數,是相當值得的習慣,同時也能讓回調成為可選參數。
function getInput(options, callback) {
allUserData.push(options);
if (typeof callback === "function") {
callback(options);
}
}
少了這層檢查,一旦呼叫方沒傳或傳錯型別,就會直接丟出執行期錯誤。
當回調是某個物件的方法時,this 的指向必須特別處理,否則它會指向全域的 window 物件或包含函數。
var clientData = {
id: 094545,
fullName: "Not Set",
setUserName: function (firstName, lastName) {
// 這裡的 this 本該指向 clientData
this.fullName = firstName + " " + lastName;
}
};
function getUserInput(firstName, lastName, callback) {
// 這裡先省略驗證邏輯
callback(firstName, lastName);
}
問題來了:
getUserInput("Barack", "Obama", clientData.setUserName);
console.log(clientData.fullName); // Not Set
console.log(window.fullName); // Barack Obama
因為 getUserInput 是全域函數,其中的 this 指向 window,於是 fullName 被寫到了 window 上,clientData 反而沒被改到。
每個函數都有 call 與 apply 兩個方法,可以用來指定函數內部的 this,並把參數傳進去。兩者的差別在於:call 的第一個參數是 this,其餘參數逐一列出;apply 的第一個參數同樣是 this,第二個參數則是參數陣列(或 arguments 物件)。
// 多收一個 callbackObj 參數,用來指定 this
function getUserInput(firstName, lastName, callback, callbackObj) {
// 這裡先省略驗證邏輯
callback.apply(callbackObj, [firstName, lastName]);
}
// 呼叫時把 clientData 一起傳入
getUserInput("Barack", "Obama", clientData.setUserName, clientData);
console.log(clientData.fullName); // Barack Obama
就像可以傳多個變量一樣,也能傳多個回調。jQuery 的 AJAX 就是典型例子:
function beforeSendCallback() {
// 送出前處理
}
function successCallback() {
// 成功收到回應時處理
}
function completeCallback() {
// 不論成功失敗都會執行
}
function errorCallback() {
// 發生錯誤時處理
}
$.ajax({
url: "https://fiddle.jshell.net/favicon.png",
success: successCallback,
complete: completeCallback,
error: errorCallback
});
異步程式碼本質上是「以不確定的順序執行」,一旦每個步驟都要等前一步完成,就容易寫出層層嵌套的結構。下面這段改寫自 node-mongodb-native 的範例,就是常被拿來當反面教材的回調地獄:
var p_client = new Db('integration_tests_20',
new Server("127.0.0.1", 27017, {}), {'pk': CustomPKFactory});
p_client.open(function (err, p_client) {
p_client.dropDatabase(function (err, done) {
p_client.createCollection('test_custom_key', function (err, collection) {
collection.insert({'a': 1}, function (err, docs) {
collection.find({'_id': new ObjectID("aaaaaaaaaaaa")},
function (err, cursor) {
cursor.toArray(function (err, items) {
test.assertEquals(1, items.length);
p_client.close();
});
});
});
});
});
});
遇到這種情況有兩個方向可以處理:
(以今天的觀點看,Promise、async/await 也是解決這個問題的主流方案。)
理解之後回頭看自己的程式碼,你會發現很多適合改用回調的地方:
舉例來說,假設我們要做一個函數:取得使用者資料、寫一首詩、歡迎使用者。若全部塞在一起,裡頭會佈滿 if/else,而且難以擴充。改用回調之後,主函數只負責取得資料,把結果交給回調去處理即可:
// 先準備好當回調用的詩人函數
function genericPoemMaker(name, gender) {
console.log(name + " is finer than fine wine.");
console.log("Altruistic and noble for the modern time.");
console.log("Always admirably adorned with the latest style.");
console.log("A " + gender + " of unfortunate tragedies who still manages a perpetual smile");
}
// 最後一個參數就是回調
function getUserInput(firstName, lastName, gender, callback) {
var fullName = firstName + " " + lastName;
if (typeof callback === "function") {
callback(fullName, gender);
}
}
呼叫時傳入不同的函數,同一個 getUserInput 就能完成完全不同的工作:
getUserInput("Michael", "Fassbender", "Man", genericPoemMaker);
/* Michael Fassbender is finer than fine wine.
Altruistic and noble for the modern time.
Always admirably adorned with the latest style.
A Man of unfortunate tragedies who still manages a perpetual smile. */
function greetUser(customerName, sex) {
var salutation = sex === "Man" ? "Mr." : "Ms.";
console.log("Hello, " + salutation + " " + customerName);
}
getUserInput("Bill", "Gates", "Man", greetUser);
// Hello, Mr. Bill Gates
同樣的呼叫方式,換一個回調就換一套行為——這正是回調的威力所在。
尤其在現代的網頁開發中,第三方函式庫與框架裡到處都是回調:
回調的語法不難,難的是在對的時機想到它。養成習慣之後,很多原本要用狀態變數迂迴處理的地方,都能收斂成乾淨的函數傳遞。