那些成长的磨砺、奋斗的汗水,都将化作你的底气和格局,累积成你向上攀爬的阶梯,支撑着你看到更高处的风景。
今日学习内容
1、JS 红皮书 P332-338 第十一章:期约与异步函数
今日笔记
1、Promise.prototype.catch(): Promise.prototype.catch()方法用于给期约添加拒绝处理程序。这个方法只接收一个参数:onRejected 处理程序。事实上,这个方法就是一个语法糖,调用它就相当于调用 Promise.prototype.then(null, onRejected)。
1 2 3 4 5 6 7
| let p = Promise.reject(); let onRejected = function(e) { setTimeout(console.log, 0, 'rejected'); };
p.then(null, onRejected); p.catch(onRejected);
|
Promise.prototype.catch()返回一个新的期约实例:
1 2 3 4 5
| let p1 = new Promise(() => {}); let p2 = p1.catch(); setTimeout(console.log, 0, p1); setTimeout(console.log, 0, p2); setTimeout(console.log, 0, p1 === p2);
|
2、Promise.prototype.finally(): Promise.prototype.finally()方法用于给期约添加 onFinally 处理程序,这个处理程序在期约转换为解决或拒绝状态时都会执行。这个方法可以避免 onResolved 和 onRejected 处理程序中出现冗余代码。但 onFinally 处理程序没有办法知道期约的状态是解决还是拒绝,所以这个方法主要用于添加清理代码。
1 2 3 4 5 6 7 8 9 10 11 12 13
| let p1 = Promise.resolve(); let p2 = Promise.reject(); let onFinally = function() { setTimeout(console.log, 0, 'Finally!') } p1.finally(onFinally); p2.finally(onFinally);
let p1 = new Promise(() => {}); let p2 = p1.finally(); setTimeout(console.log, 0, p1); setTimeout(console.log, 0, p2); setTimeout(console.log, 0, p1 === p2);
|
这个新期约实例不同于 then()或 catch()方式返回的实例。因为 onFinally 被设计为一个状态无关的方法,所以在大多数情况下它将表现为父期约的传递。对于已解决状态和被拒绝状态都是如此。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| let p1 = Promise.resolve('foo');
let p2 = p1.finally(); let p3 = p1.finally(() => undefined); let p4 = p1.finally(() => {}); let p5 = p1.finally(() => Promise.resolve()); let p6 = p1.finally(() => 'bar'); let p7 = p1.finally(() => Promise.resolve('bar')); let p8 = p1.finally(() => Error('qux')); setTimeout(console.log, 0, p2); setTimeout(console.log, 0, p3); setTimeout(console.log, 0, p4); setTimeout(console.log, 0, p5); setTimeout(console.log, 0, p6); setTimeout(console.log, 0, p7); setTimeout(console.log, 0, p8);
|
如果返回的是一个待定的期约,或者 onFinally 处理程序抛出了错误(显式抛出或返回了一个拒绝期约),则会返回相应的期约(待定或拒绝),如下所示:
1 2 3 4 5 6 7 8 9
| let p9 = p1.finally(() => new Promise(() => {})); let p10 = p1.finally(() => Promise.reject());
setTimeout(console.log, 0, p9); setTimeout(console.log, 0, p10); let p11 = p1.finally(() => { throw 'baz'; });
setTimeout(console.log, 0, p11);
|
返回待定期约的情形并不常见,这是因为只要期约一解决,新期约仍然会原样后传初始的期约:
1 2 3 4 5 6 7 8
| let p1 = Promise.resolve('foo');
let p2 = p1.finally( () => new Promise((resolve, reject) => setTimeout(() => resolve('bar'), 100))); setTimeout(console.log, 0, p2); setTimeout(() => setTimeout(console.log, 0, p2), 200);
|
3、非重入期约方法: 当期约进入落定状态时,与该状态相关的处理程序仅仅会被排期,而非立即执行。跟在添加这个处理程序的代码之后的同步代码一定会在处理程序之前先执行。即使期约一开始就是与附加处理程序关联的状态,执行顺序也是这样的。这个特性由 JavaScript 运行时保证,被称为“非重入”(non-reentrancy)特性。下面的例子演示了这个特性:
1 2 3 4 5 6 7 8 9 10
| let p = Promise.resolve();
p.then(() => console.log('onResolved handler'));
console.log('then() returns');
|
在这个例子中,在一个解决期约上调用 then()会把 onResolved 处理程序推进消息队列。但这个处理程序在当前线程上的同步代码执行完成前不会执行。因此,跟在 then()后面的同步代码一定先于处理程序执行。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
| let synchronousResolve;
let p = new Promise((resolve) => { synchronousResolve = function() { console.log('1: invoking resolve()'); resolve(); console.log('2: resolve() returns'); }; }); p.then(() => console.log('4: then() handler executes')); synchronousResolve(); console.log('3: synchronousResolve() returns');
|
在这个例子中,即使期约状态变化发生在添加处理程序之后,处理程序也会等到运行的消息队列让它出列时才会执行。
非重入适用于 onResolved/onRejected 处理程序、catch()处理程序和 finally()处理程序。下面的例子演示了这些处理程序都只能异步执行:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
| let p1 = Promise.resolve(); p1.then(() => console.log('p1.then() onResolved')); console.log('p1.then() returns'); let p2 = Promise.reject(); p2.then(null, () => console.log('p2.then() onRejected')); console.log('p2.then() returns'); let p3 = Promise.reject(); p3.catch(() => console.log('p3.catch() onRejected')); console.log('p3.catch() returns'); let p4 = Promise.resolve(); p4.finally(() => console.log('p4.finally() onFinally')); console.log('p4.finally() returns');
|
4、邻近处理程序的执行顺序: 如果给期约添加了多个处理程序,当期约状态变化时,相关处理程序会按照添加它们的顺序依次执行。无论是 then()、catch()还是 finally()添加的处理程序都是如此。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
| let p1 = Promise.resolve(); let p2 = Promise.reject(); p1.then(() => setTimeout(console.log, 0, 1)); p1.then(() => setTimeout(console.log, 0, 2));
p2.then(null, () => setTimeout(console.log, 0, 3)); p2.then(null, () => setTimeout(console.log, 0, 4));
p2.catch(() => setTimeout(console.log, 0, 5)); p2.catch(() => setTimeout(console.log, 0, 6));
p1.finally(() => setTimeout(console.log, 0, 7)); p1.finally(() => setTimeout(console.log, 0, 8));
|
5、传递解决值和拒绝理由: 到了落定状态后,期约会提供其解决值(如果兑现)或其拒绝理由(如果拒绝)给相关状态的处理程序。拿到返回值后,就可以进一步对这个值进行操作。比如,第一次网络请求返回的 JSON 是发送第二次请求必需的数据,那么第一次请求返回的值就应该传给 onResolved 处理程序继续处理。当然,失败的网络请求也应该把 HTTP 状态码传给 onRejected 处理程序。
在执行函数中,解决的值和拒绝的理由是分别作为 resolve()和 reject()的第一个参数往后传的。然后,这些值又会传给它们各自的处理程序,作为 onResolved 或 onRejected 处理程序的唯一参数。下面的例子展示了上述传递过程:
1 2 3 4 5 6 7 8 9
| let p1 = new Promise((resolve, reject) => resolve('foo')); p1.then((value) => console.log(value)); let p2 = new Promise((resolve, reject) => reject('bar')); p2.catch((reason) => console.log(reason));
let p1 = Promise.resolve('foo'); p1.then((value) => console.log(value)); let p2 = Promise.reject('bar'); p2.catch((reason) => console.log(reason));
|
6、拒绝契约与拒绝错误处理: 拒绝期约类似于 throw()表达式,因为它们都代表一种程序状态,即需要中断或者特殊处理。在期约的执行函数或处理程序中抛出错误会导致拒绝,对应的错误对象会成为拒绝的理由。因此以下这些期约都会以一个错误对象为由被拒绝:
1 2 3 4 5 6 7 8
| let p1 = new Promise((resolve, reject) => reject(Error('foo'))); let p2 = new Promise((resolve, reject) => { throw Error('foo'); }); let p3 = Promise.resolve().then(() => { throw Error('foo'); }); let p4 = Promise.reject(Error('foo')); setTimeout(console.log, 0, p1); setTimeout(console.log, 0, p2); setTimeout(console.log, 0, p3); setTimeout(console.log, 0, p4);
|
所有错误都是异步抛出且未处理的,通过错误对象捕获的栈追踪信息展示了错误发生的路径。注意错误的顺序:Promise.resolve().then()的错误最后才出现,这是因为它需要在运行时消息队列中添加处理程序;也就是说,在最终抛出未捕获错误之前它还会创建另一个期约。
这个例子同样揭示了异步错误有意思的副作用。正常情况下,在通过 throw()关键字抛出错误时,JavaScript 运行时的错误处理机制会停止执行抛出错误之后的任何指令:
1 2 3
| throw Error('foo'); console.log('bar');
|
但是,在期约中抛出错误时,因为错误实际上是从消息队列中异步抛出的,所以并不会阻止运行时继续执行同步指令:
1 2 3 4
| Promise.reject(Error('foo')); console.log('bar');
|
如本章前面的 Promise.reject()示例所示,异步错误只能通过异步的 onRejected 处理程序捕获:
1 2 3 4 5 6
| Promise.reject(Error('foo')).catch((e) => {});
try { Promise.reject(Error('foo')); } catch(e) {}
|
这不包括捕获执行函数中的错误,在解决或拒绝期约之前,仍然可以使用 try/catch 在执行函数中捕获错误:
1 2 3 4 5 6 7
| let p = new Promise((resolve, reject) => { try { throw Error('foo'); } catch(e) {} resolve('bar'); }); setTimeout(console.log, 0, p);
|
then()和 catch()的 onRejected 处理程序在语义上相当于 try/catch。出发点都是捕获错误之后将其隔离,同时不影响正常逻辑执行。为此,onRejected 处理程序的任务应该是在捕获异步错误之后返回一个解决的期约。下面的例子中对比了同步错误处理与异步错误处理:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
| console.log('begin synchronous execution'); try { throw Error('foo'); } catch(e) { console.log('caught error', e); } console.log('continue synchronous execution');
new Promise((resolve, reject) => { console.log('begin asynchronous execution'); reject(Error('bar')); }).catch((e) => { console.log('caught error', e); }).then(() => { console.log('continue asynchronous execution'); });
|