關於 Promise 是什麼、解決了什麼問題,只要親身寫過 Node.js 的多層回調就會明白,也可參考 CommonJS 的 Promises/A 規範。這裡直接看如何用 q.js 把 Node 的 API 改造成 Promise。
npm install q
相對於 Q.fcall,nfcall 專門用來包裝 Node 風格的回調函數:
var FS = require('fs'),
Q = require('q'),
colors = require('colors'),
file = 'example.txt';
var fsReadFile = Q.nfcall(FS.readFile, file, encoding);
fsReadFile.then(function (result) {
console.log(("invoke in nfcall " + file).red);
console.log(result.green);
}, function (error) {
console.log("invoke in nfcall".red);
console.log(error.toString().red);
});
先反覆使用的 API 包裝成函數,之後重複呼叫:
var fsReadFile_denodeify = Q.denodeify(FS.readFile);
fsReadFile_denodeify(file, encoding).then(function (result) {
console.log("invoke in denodeify".red);
console.log(result.green);
}, function (error) {
console.log("invoke in denodeify".red);
console.log(error.toString().red);
});
最耗字但也最可控,適合需要自行決定 resolve / reject 時機的場景:
var fsReadFile_deferd = function (file, encoding) {
var deferred = Q.defer();
FS.readFile(file, encoding, function (error, result) {
if (error) {
deferred.reject(error.toString().red);
return;
}
deferred.resolve(result);
});
return deferred.promise;
};
fsReadFile_deferd(file).then(function (result) {
console.log("invoke in deferd".red);
console.log(result.toString().green);
}, function (error) {
console.log("invoke in deferd".red);
console.log(error.toString().red);
});
由 deferred 直接產生一個 Node 風格的 resolver,省去自己拆 error 與 result:
var fsReadFile_makeNodeResolver = function (file, encoding) {
var deferred = Q.defer();
FS.readFile(file, encoding, deferred.makeNodeResolver());
return deferred.promise;
};
fsReadFile_makeNodeResolver(file, encoding).then(function (result) {
console.log("invoke in makeNodeResolver".red);
console.log(result.green);
}, function (error) {
console.log(error.toString().red);
});
若只是要快速包裝現成的 Node API,nfcall 與 denodeify 最省事;需要介入流程時再用 defer 或 makeNodeResolver。順帶一提,Node 已原生支援 util.promisify,而 async/await 更能把非同步流程寫得像同步程式碼,新專案已不太需要額外引入 q.js。