JavaScript基础——Promise使用指南
原创
在上篇文章里《JavaScript基础——回调(callback)是什么》我们一起学习了回调，明白了回调就是一个在另外一个函数执行完后要执行的函数，如果我们希望异步函数能够像同步函数那样顺序执行，只能嵌套使用回调函数，过多的回调嵌套会使得代码变得难以理解与维护，为了避免“回调地狱”让人发狂的行为，ES6原生引入了promise的模式，通过这种方式，让我们代码看起来像同步代码，大大简化了异步编程，简直是ES6新特性中最让我们兴奋的特性之一。
什么是promise?
首先我们看看promise这个单词的中文释义，作为名词解释为承诺、诺言、誓言、约言，从中文释义可以看出，是一个未发生，将来一定会发生的某种东东…… 接下来我们来看看ECMA委员会怎么定义Promise的：
A Promise is an object that is used as a placeholder for the eventual results of a deferred (and possibly asynchronous) computation.
Promise是一个对象，用作占位符，用于延迟（可能是异步）计算的最终结果。
简单的来说，Promise就是装载未来值的容器。其实生活中有很多Promise的场景，设想以下的场景：我们去快餐店点餐，你点了一份牛肉面，你扫码付款后，会拿到一份带订单号的收据。订单号就是快餐店给我们的一份牛肉面的承诺(promise)，保证了你会得到一份牛肉面。
所以我们一定要包管好我们的订单收据，因为我们知道了这个收据代表了我们未来会有一份牛肉面，尽管快餐店不能马上给我们一份牛肉面，但是我们大脑潜意识的把订单收据当做牛肉面的“占位符”了
终于，我们听到服务员在喊“100号的牛肉面好了，请到窗口取餐”，然后我们拿着订单收据来到窗口递给服务员，我们换来了牛肉面。
说了很多，简单描述这个概念就是一旦我们需要的值准备好了，我们就用对我的承诺值换取这个值本身。
但是，还有一种不好的结果，服务员叫到我们的订单号，当我们去拿的时候，服务员会一脸歉意的告诉我们“十分抱歉，您的牛肉面卖完了”。作为顾客的我们对这个情况，除了愤怒之外只能换个地吃饭了或者点其它的。从中我们可以看出，未来值还有一个重要的特性：它可能成功也可能失败。
生活的例子很简单我们都经历过，我们是不是特别着急如何用Promise呢？在使用之前，我们还是先了解下——Promise State(承诺状态，注：暂且这么翻译，小编也不知道如何翻译更好)
Promise State(承诺状态)
Promise只会处在以下状态之一：
Pending(待处理): promise初始化的状态，正在运行，既未完成也没有失败的状态，此状态可以迁移至fulfilled和rejected状态。
Fulfilled(已完成):如果回调函数实现Promise的resolve回调（稍后介绍），那我们的promise实现兑现。
Rejected(已拒绝)：如果Promise调用过程中遭到拒绝或者发生异常，那么我们的promise被拒绝,处于Rejected（状态）。
Settled（不可更改的）:Promise如果不处在Pending状态，状态就会改变，要不是Fulfilled要不是Rejected这两种状态。
Promise的状态转换，可以用下面一张图进行表示（图片来源：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise#Methods）
Promise vs callback
比如我们有个需求，需要通过AJAX实现三个请求，第二个和第三个请求都依赖上一个接口的请求，如果使用CallBack的方式，我们的代码可能是这样的：
ajaxCall('http://example.com/page1', response1 => {
ajaxCall('http://example.com/page2'+response1, response2 => {
ajaxCall('http://example.com/page3'+response2, response3 => {
console.log(response3)
}
})
}) 大家很快就会发现，这种多重嵌套的代码不但难以理解，而且难以维护，这就是著名的“回调地狱”现象。
如果使用Promise则会让我们的大脑更容易接受和理解，代码显得简单扁平化，代码调用如下，如何实现ajaxCallPromise稍后介绍：
ajaxCallPromise('http://example.com/page1')
.then( response1 => ajaxCallPromise('http://example.com/page2'+response1) )
.then( response2 => ajaxCallPromise('http://example.com/page3'+response2) )
.then( response3 => console.log(response3) ) 你是不是觉得代码的复杂性突然降低，代码看起来更简单易读呢，你也许会问ajaxCallPromise怎么写？，别着急，接着往下看
Promise实现——(resolve, reject) 方法
要实现回调函数转换成Promise对象，我们需要使用Promise构造函数，在上一小节，小编展示了ajaxCallPromise函数是如何调用的,ajaxCallPromise的实现内容如下，小编实现了(resolve,reject)相应的回调函数：
const ajaxCallPromise = url => {
return new Promise((resolve, reject) => {
// DO YOUR ASYNC STUFF HERE
$.ajaxAsyncWithNativeAPI(url, function(data) {
if(data.resCode === 200) {
resolve(data.message)
} else {
reject(data.error)
}
})
})
} 如何理解这段代码呢？
- 首先定义ajaxCallPromise返回类型为Promise，这意味我们会实现一个Promise的承诺。
- Promise接受两个函数参数，resolve（成功实现承诺）和reject（异常或失败）
- resolve和reject这两个特有的方法，会获取对应成功或失败的值
- 如果接口请求一切正常，我们将会通过resolve函数接收返回的值
- 如果接口请求失败，我们将会通过reject回调接收失败返回的值
再举个简单的例子，如果foo()和bar()函数都实现promise,我们改怎么写呢？
方式一：
foo().then( res => {
bar().then( res2 => {
console.log('Both done')
})
}) 方式二（建议这种，简单易读）
foo()
.then( res => bar() ) // bar() returns a Promise
.then( res => {
console.log('Both done')
}) .then(onFulfilled, onRejected) 方法
Promise的then()方法允许我们在任务完成后或拒绝失败后执行相应的任务，该任务可以是基于另外一个事件或基于回调的异步操作。
Promise的then()方法接收两个参数，即onFulfilled 和 onRejected 的回调，如果Promise对象完成，如果成功状态则执行onFulfilled回调，如果异常或失败则执行onRejected回调。
简单的来说，onFulfilled回调接收一个参数，及所谓的未来的值，同样 onRejected 也接收一个参数，显示拒绝的原因。让我们改动下上小节ajaxCallPromise的then()方法：
ajaxCallPromise('http://example.com/page1').then(
successData => { console.log('Request was successful') },
failData => { console.log('Request failed' + failData) }
) 如果请求过程失败，第二个函数将会执行输出而不是第一个函数输出。
我们一起再来看个简单的例子，我们在setTimeout()实现Promise回调，代码如下：
const PsetTimeout = duration => {
return new Promise((resolve, reject) => {
setTimeout( () => {
resolve()
}, duration);
})
}
PsetTimeout(1000)
.then(() => {
console.log('Executes after a second')
}) 这里我们在这里实现了一个成功状态后没有返回成功状态值的Promise，函数执行后，成功返回后未来值将会是 undefined.
catch(onRejected)方法
除了then()方法可以处理错误和异常，使用Promise的catch()方法也能实现同样的功能，这个方法其实并没有什么特别，只是更容易理解而已，我们一眼就能明白是捕获异常的操作。
catch()方法只接收一个回调函数。catch()方法的onRejected回调的调用方式与then()方法的onRejected回调相同。
还记得我们上小节ajaxCallPromise的then()方法的实现吗：
ajaxCallPromise('http://example.com/page1').then(
successData => { console.log('Request was successful') },
failData => { console.log('Request failed' + failData) }
) 我们还可以使用catch()方法进行捕获异常或拒绝，效果是一致的。
ajaxCallPromise('http://example.com/page1’)
.then(successData => console.log('Request was successful’))
.catch(failData => console.log('Request failed' + failData)); Promise.resolve(value)方法
Promise的resolve()方法接收成功返回值并返回一个Promise对象，用于未来值的传递，将值传递给.then(onFulfilled, onRejected) 的onFulfilled回调中。resolve()方法可以用于将未来值转化成Promise对象，下面的一段代码演示了如何使用Promise.resolve()方法:
const p1 = Promise.resolve(4);
p1.then(function(value){
console.log(value);
}); //passed a promise object
Promise.resolve(p1).then(function(value){
console.log(value);
});
Promise.resolve({name: "Eden"})
.then(function(value){
console.log(value.name);
}); 控制台将会输出以下内容：
4
4
Eden Promise.reject(value)方法
Promise.reject(value)方法与上小节Promise.resolve(value)类似，唯一不同的是将值传递给.then(onFulfilled, onRejected) 的onRejected回调中，同时Promise.reject(value)主要用来进行调试。
让我们看看下面一段代码如何使用Promise.reject(value)方法：
const p1 = Promise.reject(4);
p1.then(null, function(value){
console.log(value);
});
Promise.reject({name: "Eden"})
.then(null, function(value){
console.log(value.name);
}); 控制台将输出：
4
Eden Promise.all(iterable) 方法
该方法传入迭代的Promise数组对象，并一起返回一个Promise对象，当所有的Promise迭代对象成功返回后，整个Promise才能返回成功状态的值。
好了，我们一起看看怎么实现Promise.all(iterable) 方法：
const p1 = new Promise(function(resolve, reject){
setTimeout(function(){
resolve();
}, 1000);
});
const p2 = new Promise(function(resolve, reject){
setTimeout(function(){
resolve();
}, 2000);
});
const arr = [p1, p2];
Promise.all(arr).then(function(){
console.log("Done"); //"Done" is logged after 2 seconds
}); 特别需要注意的一点，在迭代数组中，只要任意一个进入失败状态，那么该方法返回的对象也会进入失败状态，并将那个进入失败状态的错误信息作为自己的错误信息，示例代码如下：
const p1 = new Promise(function(resolve, reject){
setTimeout(function(){
reject("Error");
}, 1000);
});
const p2 = new Promise(function(resolve, reject){
setTimeout(function(){
resolve();
}, 2000);
});
const arr = [p1, p2];
Promise.all(arr).then(null, function(reason){
console.log(reason); //"Error" is logged after 1 second
}); Promise.race(iterable) 方法
与Promise.all(iterable) 不同的是，Promise.race(iterable) 虽然也接收包含若干个Promise对象的可迭代对象，不同的是这个方法会监听所有的Promise对象，并等待其中的第一个进入完成或失败状态的Promise对象，一旦有Promise对象满足，整个Promise对象将返回这个Promise对象的成功状态或失败状态，下面的示例展示了返回第一个成功状态的值：
var p1 = new Promise(function(resolve, reject){
setTimeout(function(){
resolve("Fulfillment Value 1");
}, 1000);
});
var p2 = new Promise(function(resolve, reject){
setTimeout(function(){
resolve("fulfillment Value 2");
}, 2000);
});
var arr = [p1, p2];
Promise.race(arr).then(function(value){
console.log(value); //Output "Fulfillment value 1"
}, function(reason){
console.log(reason); 用Promise改写上篇文章的回调方法
读过《JavaScript基础——回调(callback)是什么》文章同学，文章的最后我们用回调函数实现了一个真实的业务场景——用NodeJs实现从论坛帖子列表中显示其中的一个帖子的信息及留言列表信息，如果使用本篇文章学习到的内容，我们如何实现呢, 代码如下：
index.js
const fs = require('fs');
const path = require('path');
const postsUrl = path.join(__dirname, 'db/posts.json');
const commentsUrl = path.join(__dirname, 'db/comments.json');
//return the data from our file
function loadCollection(url) {
return new Promise(function(resolve, reject) {
fs.readFile(url, 'utf8', function(error, data) {
if (error) {
reject('error');
} else {
resolve(JSON.parse(data));
}
});
});
}
//return an object by id
function getRecord(collection, id) {
return new Promise(function(resolve, reject) {
const data = collection.find(function(element){
return element.id == id;
});
resolve(data);
});
}
//return an array of comments for a post
function getCommentsByPost(comments, postId) {
return comments.filter(function(comment){
return comment.postId == postId;
});
}
//initialization code
loadCollection(postsUrl)
.then(function(posts){
return getRecord(posts, "001");
})
.then(function(post){
console.log(post);
return loadCollection(commentsUrl);
})
.then(function(comments){
const postComments = getCommentsByPost(comments, "001");
console.log(postComments);
})
.catch(function(error){
console.log(error);
}); 结束语：
本篇的内容就介绍到这里，各位是否看的很过瘾，虽然Promise已经比回调函数好许多，但是还是不够简洁，不够符合我们人类大脑思考逻辑，如果我们能以书写同步的方法书写异步代码，那该多好啊，ES8引入了async/await让我们能用同步的方式书写异步代码，想想就很激动，小编将会在下篇文章进行介绍，敬请期待!
更多精彩内容，请微信关注”前端达人”公众号！
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
腾讯云开发者
