Promise对象
文章目录

Promise 对象

Promise 是啥

所谓Promise,简单说就是一个容器,里面保存着某个未来才会结束的事件(通常是一个异步操作)的结果。从语法上说,Promise 是一个对象,从它可以获取异步操作的消息。Promise 提供统一的 API,各种异步操作都可以用同样的方法进行处理。

高级版的Callback

几个特性:

  1. 对象的状态不受外界影响。

    完全隔离的多线程

    Promise对象代表一个异步操作,有三种状态:Pending(进行中)、Resolved(已完成,又称 Fulfilled)和Rejected(已失败)。只有异步操作的结果,可以决定当前是哪一种状态,任何其他操作都无法改变这个状态。

  2. 一旦状态改变,就不会再变,任何时候都可以得到这个结果。

    Promise对象的状态改变,只有两种可能:从Pending变为Resolved和从Pending变为Rejected。只要这两种情况发生,状态就凝固了,不会再变了,会一直保持这个结果。如果改变已经发生了,你再对Promise对象添加回调函数,也会立即得到这个结果。这与事件(Event)完全不同,事件的特点是:如果你错过了它,再去监听,是得不到结果的。

几个缺陷:

  1. 无法取消Promise,一旦新建它就会立即执行,无法中途取消。
  2. 如果不设置回调函数,Promise内部抛出的错误,不会反应到外部。
  3. 当处于Pending状态时,无法得知目前进展到哪一个阶段(刚刚开始还是即将完成)。

关于用法

Promise对象

Promise对象是一个构造函数,用来生成Promise实例。下面代码创造了一个Promise实例。

1
2
3
4
5
6
7
8
9
var promise = new Promise(function(resolve, reject) {
// ... some code

if (/* 异步操作成功 */){
resolve(value);
} else {
reject(error);
}
});

Promise()的参数

Promise构造函数接受一个函数作为参数,该函数的两个参数分别是resolvereject

这两个参数是两个函数,由JavaScript引擎提供,不用自己部署。

  • resolve函数的作用是,将Promise对象的状态从“未完成”变为“成功”(即从Pending变为Resolved),在异步操作成功时调用,并将异步操作的结果,作为参数传递出去;
  • reject函数的作用是,将Promise对象的状态从“未完成”变为“失败”(即从Pending变为Rejected),在异步操作失败时调用,并将异步操作报出的错误,作为参数传递出去。

then函数中处理回调

Promise实例生成以后,可以用then方法分别指定Resolved状态和Reject状态的回调函数。

1
2
3
4
5
promise.then(function(value) {
// success
}, function(error) {
// failure
});

then方法可以接受两个回调函数作为参数。第一个回调函数是Promise对象的状态变为Resolved时调用,第二个回调函数是Promise对象的状态变为Reject时调用。其中,第二个函数是可选的,不一定要提供。这两个函数都接受Promise对象传出的值作为参数。

一个简(fu)单(za)的例子:

1
2
3
4
5
6
7
8
9
10
11
function timeout(ms) {
return new Promise((resolve, reject) => {
setTimeout(resolve, ms, 'done'); //一定时间之后执行resolve(done)
});
}

//then可以有两个参数,两个参数都是函数,这里演示Resolved状态的callback故只给了第一个参数来处理成功的情况,
timeout(100).then((value) => {
console.log(value);
});
console.log(123);

then方法指定的回调函数,将在当前脚本所有同步任务执行完才会执行,所以“Resolved”最后输出。因此上方代码对应输出:

1
2
123
done

另一个演示执行Reject时并且未设定Callback的报错情况:

1
2
3
4
5
6
7
8
9
var promise =  new Promise((resolve, reject) => {
if (true) reject('failed');
});

promise.then((value) => {
console.log(value);
}); // Error: Uncaught (in promise), 因为我们只设定了`Resolved`的callback

console.log('test'); //下方代码依然会执行,JS不会中断

AJAX例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
var getJSON = function(url) {
var promise = new Promise(function(resolve, reject){ //围绕整个AJAX处理函数
var client = new XMLHttpRequest();
client.open("GET", url);
client.onreadystatechange = handler;
client.responseType = "json";
client.setRequestHeader("Accept", "application/json");
client.send();

function handler() {
if (this.readyState !== 4) {
return;
}
if (this.status === 200) {
resolve(this.response); //Resolved!
} else {
reject(new Error(this.statusText)); //Rejected!
}
};
});

return promise;
};

getJSON("/posts.json").then(function(json) {
console.log('Contents: ' + json);
}, function(error) {
console.error('出错了', error);
});

resolve函数和reject函数的参数

如果调用resolve函数和reject函数时带有参数,那么它们的参数会被传递给回调函数。

  • reject函数的参数通常是Error对象的实例,表示抛出的错误;
  • resolve函数的参数除了正常的值以外,还可能是另一个Promise实例,表示异步操作的结果有可能是一个值,也有可能是另一个异步操作,比如像下面这样:
1
2
3
4
5
6
7
8
var p1 = new Promise(function (resolve, reject) {
// ...
});

var p2 = new Promise(function (resolve, reject) {
// ...
resolve(p1);
})

这时p1的状态就会传递给p2,也就是说,p1的状态决定了p2的状态。如果p1的状态是Pending,那么p2的回调函数就会等待p1的状态改变;如果p1的状态已经是Resolved或者Rejected,那么p2的回调函数将会立刻执行。

Promise会立即执行,但是p1没有完成之前p2依然保持Pending状态

一个例子:

1
2
3
4
5
6
7
8
9
10
11
12
var p1 = new Promise(function (resolve, reject) {
setTimeout(() => reject(new Error('fail')), 3000)
})

var p2 = new Promise(function (resolve, reject) {
setTimeout(() => resolve(p1), 1000) //注意一般resolve函数才会返回另一个promise
})

p2
.then(result => console.log(result))
.catch(error => console.log(error))
// Error: fail

运行详细(忽略两个Promise直接的运行间隔):

| 时间 | p1状态 |p2状态 |
| | | |
| 0s | 初始化并开始倒计时 | 初始化并开始倒计时 |
| 1s | Pending,继续倒计时 | Pending,希望执行resolve(p1)但是p1处于Pending状态 |
| 2s | Pending,继续倒计时 | Pending,希望执行resolve(p1)但是p1处于Pending状态 |
| 3s | Rejected | 执行resolve(p1),因为p1被Rejected因此自己也被Rejected |

参考文献

http://es6.ruanyifeng.com/#docs/promise