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教程
网友评论