Promise 是一个对象,存储一个状态。这个状态是可以随着内部的执行转化的,为以下三种状态之一:
- 等待态(Pending)
- 完成态(Fulfilled)
- 拒绝态(Rejected)
使用:先设置好 状态从 pending 变成 fulfilled 和 rejected 的预案(我觉得类似 ajax 的 done 和 fail 里的处理,成功时做什么,失败时做什么)
Promise 启动之后,当满足成功的条件时让状态从 pending 变成 fulfilled (执行 resolve);当满足失败的条件时让状态从 pending 变成 rejected (执行 reject)
Promise.prototype.then / Promise.prototype.catch
.then ( resolve [ , reject ] )
then 方法为 Promise 实例添加状态改变时的回调函数。第一个参数是 resolved 状态的回调函数,第二个参数(可选)是 rejected 状态的回调函数。
then 方法返回的是一个新的 Promise 实例,不是原来那个 Promise 实例。可以采用链式写法,即 then 方法后面再调用另一个 then 方法。
getJSON("/posts.json").then(function(json) {
return json.post;
}).then(function(post) {
// ...
});
上面的代码使用 then 方法依次指定了两个回调函数。第一个回调函数完成以后,会将返回结果作为参数,传入第二个回调函数。
采用链式的 then,可以指定一组按照次序调用的回调函数。前一个回调函数有可能返回的还是一个 Promise 对象(有异步操作),后一个回调函数就会等待该 Promise 对象的状态发生变化,才会被调用。
getIp().then(function(ip){
return getCityFromIp(ip)
}).then(function(city){
return getWeatherFromCity(city)
}).then(function(data){
console.log(data)
}).catch(function(e){
console.log('出现了错误', e)
})
.catch( reject )
catch 方法用于指定发生错误时的回调函数。
Promise.prototype.catch 是 .then(null, rejection) 或 .then(undefined, rejection) 的别名。
一个 Promise 对象,如果对象状态变为 resolved,则会调用 then 方法指定的回调函数;如果异步操作抛出错误,状态就会变为 rejected,就会调用 catch 方法指定的回调函数,处理这个错误。另外,then 方法指定的回调函数,如果运行中抛出错误,也会被 catch 方法捕获。
// 写法一
const promise = new Promise(function(resolve, reject) {
try {
throw new Error('test');
} catch(e) {
reject(e);
}
});
promise.catch(function(error) {
console.log(error);
});
// 写法二
const promise = new Promise(function(resolve, reject) {
reject(new Error('test'));
});
promise.catch(function(error) {
console.log(error);
});
上面两种写法等价,比较可以发现,reject 方法的作用,等同于抛出错误。
需要注意的是,因为 Promise 状态改变之后就不会再变。如果 Promise 的状态已经变成了 resolved,再抛出错误是无效的。在 resolved 语句后面再抛出错误,不会被捕获,等于没有抛出。
一般来说,不要在 then 方法里面定义 Reject 状态的回调函数(即 then 的第二个参数),总是使用 catch 方法。理由是 catch 方法可以捕获前面的 then 方法执行中的错误,也更接近同步的写法(try {} catch {})。
Promise.all
Promise.all 方法用于多个 Promise 实例,包装成一个新的 Promise 实例。
var p = Promise.all([p1,p2,p3])
Promise.all 方法接受一个数组作为参数,p1,p2,p3都是 Promise 的实例;如果不是,会调用 Promise.resolve 方法,将参数转为 Promise 实例,再进一步处理。
Promise.all 方法的参数可以不是数组,但必须具有 Iterator 接口,且返回的每个成员都是 Promise 实例。
由方法包装的一个 新的 Promise 实例的状态 由参数数组的 Promise 实例的状态决定:
- (就上面的代码来说)只有
p1、p2、p3的状态都变成fulfilled,p的状态才会变成fulfilled,此时p1、p2、p3的返回值组成一个数组,传递给p的回调函数; - 只要
p1、p2、p3之中有一个被rejected,p的状态就变成rejected,此时第一个被reject的实例的返回值,会传递给p的回调函数。
Promise.race
Promise.race 方法同样是将多个 Promise 实例,包装成一个新的 Promise 实例。
var p = Promise.race([p1,p2,p3])
只要p1、p2、p3之中有一个实例率先改变状态,p 的状态就跟着改变。那个率先改变的 Promise 实例的返回值,就传递给p的回调函数。
如果指定时间内没有获得结果,就将 Promise 的状态变为 reject,否则变为 resolve
const p = Promise.race([
fetch('/resource-that-may-take-a-while'),
new Promise(function (resolve, reject) {
setTimeout(() => reject(new Error('request timeout')), 5000)
})
]);
p
.then(console.log)
.catch(console.error);
上面代码中,如果 5 秒之内 fetch 方法无法返回结果,变量 p 的状态就会变为 rejected,从而触发 catch 方法指定的回调函数。
参考:
阮一峰 ES6教程