Node.js 建立在 V8 之上,是單執行緒的。為了不讓讀檔、查資料庫、發 HTTP 請求這些 I/O 操作把整個流程卡死,Node 採用了事件驅動的非同步模型。對從其他語言搬過來的開發者而言,這是最容易水土不服的一塊。
這個系列會由淺入深,從 callback 一路談到 thunk、Promise、co,直到 ES7 的 async/await。本篇先把最原始的 callback 寫法講透。
ip.json 裡存著一組 IP:
// ip.json ["115.29.230.208", "180.153.132.38", "74.125.235.224", "91.239.201.98", "60.28.215.115"]
目標是查出每個 IP 對應的地區與天氣,整理後寫進 weather.json:
// weather.json
[
{ "ip": "115.29.230.208", "weather": "Clouds", "region": "Zhejiang" },
{ "ip": "180.153.132.38", "weather": "Clear", "region": "Shanghai" },
{ "ip": "74.125.235.224", "weather": "Rain", "region": "California" },
{ "ip": "60.28.215.115", "weather": "Clear", "region": "Tianjin" }
]拆成四步:讀 IP → 查地理位置 → 查天氣 → 寫檔。為了練習,這裡全部用非同步 API。
// callback.js
var fs = require('fs')
var request = require('request')
var qs = require('querystring') function readIP(path, callback) {
fs.readFile(path, function(err, data) {
if (err) {
callback(err)
} else {
try {
data = JSON.parse(data)
callback(null, data)
} catch (error) {
callback(error)
}
}
})
}注意 callback 的簽名:callback(err, data)。成功時 err 為 null,失敗時只回 err。這就是 Node 的錯誤優先(error-first)慣例。
function ip2geo(ip, callback) {
var url = 'https://www.telize.com/geoip/' + ip
request({ url: url, json: true }, function(err, resp, body) {
callback(err, body)
})
}
function geo2weather(lat, lon, callback) {
var params = { lat: lat, lon: lon, APPID: 'your-appid' }
var url = 'https://api.openweathermap.org/data/2.5/weather?' + qs.stringify(params)
request({ url: url, json: true }, function(err, resp, body) {
callback(err, body)
})
}這是最關鍵的一段。五個 IP 要同時查,不能一個等一個,所以我們用計數器 remain 來判斷「全部完成了沒」:
function ips2geos(ips, callback) {
var geos = []
var ip
var remain = ips.length
for (var i = 0; i < ips.length; i++) {
ip = ips[i];
(function(ip) { // 用 IIFE 鎖定迴圈變數
ip2geo(ip, function(err, geo) {
if (err) {
callback(err)
} else {
geo.ip = ip
geos.push(geo)
remain--
}
if (remain == 0) {
callback(null, geos)
}
})
})(ip)
}
}
function geos2weathers(geos, callback) {
var weathers = []
var geo
var remain = geos.length
for (var i = 0; i < geos.length; i++) {
geo = geos[i];
(function(geo) {
geo2weather(geo.latitude, geo.longitude, function(err, weather) {
if (err) {
callback(err)
} else {
weather.geo = geo
weathers.push(weather)
remain--
}
if (remain == 0) {
callback(null, weathers)
}
})
})(geo)
}
} function writeWeather(weathers, callback) {
var output = []
for (var i = 0; i < weathers.length; i++) {
var weather = weathers[i]
output.push({
ip: weather.geo.ip,
weather: weather.weather[0].main,
region: weather.geo.region
})
}
fs.writeFile('./weather.json', JSON.stringify(output, null, ' '), callback)
}最直覺的寫法是巢狀:
function handlerError(err) { console.log('error: ' + err) }
readIP('./ip.json', function(err, ips) {
if (err) { handlerError(err) }
else {
ips2geos(ips, function(err, geos) {
if (err) { handlerError(err) }
else {
geos2weathers(geos, function(err, weathers) {
if (err) { handlerError(err) }
else {
writeWeather(weathers, function(err) {
if (err) { handlerError(err) }
else { console.log('success!') }
})
}
})
}
})
}
})很多人一看就說「這就是 callback地獄」。但其實把它攤平成具名函式就清楚多了:
function ReadIPCallback(err, ips) {
if (err) { handlerError(err) } else { ips2geos(ips, ips2geosCallback) }
}
function ips2geosCallback(err, geos) {
if (err) { handlerError(err) } else { geos2weathers(geos, geos2weathersCallback) }
}
function geos2weathersCallback(err, weathers) {
if (err) { handlerError(err) } else { writeWeather(weathers, writeWeatherCallback) }
}
function writeWeatherCallback(err) {
if (err) { handlerError(err) } else { console.log('success!') }
}
readIP('./ip.json', ReadIPCallback)執行 node callback.js 後就會產生 weather.json。
攤平之後你會發現,巢狀根本不是核心痛點。真正的問題是:非同步本質上要處理三件事——
1. 什麼時候結束?需要一個通知機制,callback 就是一種答案。
2. 結果怎麼傳回來?callback 透過參數把資料回傳。
3. 出錯怎麼辦?callback 透過 err 參數回報。
而這三件事在每個函式裡都要重複寫一遍 if (err) ... else ...。這種「樣板程式」才是真正令人痛苦的部分,也是後續 Promise、async/await 想解決的目標。
另外提醒:範例中的第三方服務(telize、openweathermap)與 request 套件如今多已停止維護或需自行申請金鑰,實作時請替換為現行可用的服務與 fetch/axios。