promise/deferred 是處理異步編碼的一套很好的規範。本文以 Node.js 程式碼為例,動手實作一個符合 Promise/A 規範的簡易版本,幫助你真正理解它背後的原理。
/**
* Created with JetBrains WebStorm.
* User: xuwenmin
* Date: 14-4-1
* Time: 上午9:54
*/
var EventEmitter = require('events').EventEmitter;
var http = require('http');
var util = require('util');
// 定義 promise 物件
var Promise = function(){
// 實現繼承事件類
EventEmitter.call(this);
}
// 繼承事件通用方法
util.inherits(Promise, EventEmitter);
// then 方法為 promise/A 規範中的方法
Promise.prototype.then = function(successHandler, errorHandler, progressHandler){
if (typeof successHandler == 'function'){
this.once('success', successHandler);
}
if (typeof errorHandler === 'function'){
this.once('error', errorHandler);
}
if (typeof progressHandler === 'function'){
this.on('process', progressHandler);
}
return this;
}
// 定義延遲物件
// 包含一個狀態和一個 promise 物件
var Deferred = function(){
this.state = 'unfulfilled';
this.promise = new Promise();
}
Deferred.prototype.resolve = function(obj){
this.state = 'fulfilled';
this.promise.emit('success', obj);
}
Deferred.prototype.reject = function(err){
this.state = 'failed';
this.promise.emit('error', err);
}
Deferred.prototype.progress = function(data){
this.promise.emit('process', data);
}
// 利用一個 http 請求來運用上面定義的 promise/deferred
var client = function(){
var options = {
hostname:'www.baidu.com',
port:80,
path:'/',
method: 'get'
};
var deferred = new Deferred();
var req = http.request(options, function(res){
res.setEncoding('utf-8');
var data = '';
res.on('data', function(chunk){
data += chunk;
deferred.progress(chunk);
});
res.on('end', function(){
deferred.resolve(data);
});
});
req.on('error', function(err){
deferred.reject(err);
})
req.end();
return deferred.promise;
}
client().then(function(data){
console.log('請求完成', data);
}, function(err){
console.log('訪問錯誤', err);
}, function(chunk){
console.log('正在讀取', chunk);
});
這個實作由三個核心部分組成:
then 方法就是 Promise/A 規範的核心——分別註冊成功(success)、錯誤(error)與進度(process)三種處理器。resolve 觸發成功事件、reject 觸發錯誤事件、progress 觸發進度事件,並同步更新內部狀態。progress、完成時呼叫 resolve、出錯時呼叫 reject,最後回傳 promise 供外部以 then 串接處理。把程式碼存為 promise.js,在命令列下執行 node promise.js,就能看到「正在讀取 → 請求完成」的實際運行效果。
透過親手實作,你會發現 Promise 的核心其實就是「狀態 + 事件通知」的組合。理解了這層原理,再回頭使用各家 Promise 庫時,就能更加游刃有餘。