Promise 对象用于异步计算。一个 Promise 表示一个现在或将来可用,亦或永远不可用的值。
语法
new Promise(
/* executor */
function(resolve, reject) {...}
);
executor
是一个带有 resolve
和 reject
两个参数的函数 。executor
函数由 Promise
的实现立即执行,传递 resolve
和 reject
函数。
resolve
和 reject
函数,当被调用时,分别解决或拒绝 promise
。
executor
通常会启动一些异步工作,然后,一旦完成,可以调用 resolve
函数来解决 promise
,否则在发生错误时拒绝它。
如果在 executor
函数中抛出一个错误,那么该 promise
将被拒绝。executor
的返回值被忽略。
一个简单的示例
var myFirstPromise = new Promise(function(resolve, reject) {
// 当异步代码执行成功时,我们才会调用 resolve(...), 当异步代码失败时就会调用 reject(...)
// 在本例中,我们使用 setTimeout(...) 来模拟异步代码,实际编码时可能是 XHR 请求或是 HTML5 的一些API 方法.
setTimeout(function(){
resolve("成功!"); // 代码正常执行!
// 或者调用 reject('失败!')
}, 250);
});
myFirstPromise.then(
function(successMessage) {
// successMessage 的值是上面调用 resolve(...) 方法传入的值.
// successMessage 参数不一定非要是字符串类型,这里只是举个例子
console.log("Yay! " + successMessage);
}).catch(
// 记录被拒绝的理由(异常信息)
function(reason) {
console.log('Handle rejected promise ('+reason+') here.');
});