05-Promise入门详解

为什么需要 Promise?

我们在前面的文章《JavaScript 基础:异步编程和 Ajax/单线程和异步》中讲过,Javascript 是⼀⻔单线程语⾔。早期我们解决异步场景时,⼤部分情况都是通过回调函数来进⾏。

(如果你还不了解单线程和异步的概念,可以先去回顾上一篇文章。)

回调的定义

把函数 A 传给另一个函数 B 调用,那么函数 A 就是回调函数。

例如在浏览器中发送 ajax 请求,就是常⻅的⼀个异步场景,发送请求后,需要等待一段时间,等服务端响应之后我们才能拿到结果。如果我们希望在异步结束之后执⾏某个操作,就只能通过回调函数这样的⽅式进⾏操作。

  1. var dynamicFunc = function (callback) {
  2. setTimeout(function () {
  3. callback();
  4. }, 1000);
  5. };
  6. dynamicFunc(function () {
  7. console.log('qian gu');
  8. });

例如上⾯这个例⼦,dynamicFunc 就是⼀个异步函数,⾥⾯ setTimeout 会在 1s 之后调⽤传⼊的 callback 函数。按照上⾯的调⽤⽅式,最终 1s 之后,会打印 qian gu 这个结果。

为了能使回调函数以更优雅的⽅式进⾏调⽤,在 ES6 语法中,新增了⼀个名为 Promise 的新规范。

回调的缺点

回调的写法比较直观,不需要 return,层层嵌套即可。但也存在两个问题:

    1. 如果嵌套过深,则会出现回调地狱的问题。
    1. 不同的函数,回调的参数,在写法上可能不一致,导致不规范、且需要单独记忆

我们来具体看看这两个问题。

1、回调地狱的问题

如果多个异步函数存在依赖关系(比如,需要等第一个异步函数执行完成后,才能执行第二个异步函数;等第二个异步函数执行完毕后,才能执行第三个异步函数),就需要多个异步函数进⾏层层嵌套,⾮常不利于后续的维护,而且会导致回调地狱的问题。

关于回调地狱,我们来举一个形象的例子:

假设买菜、做饭、洗碗、倒厨余垃圾都是异步的。

但真实的场景中,实际的操作流程是:买菜成功之后,才能开始做饭。做饭成功后,才能开始洗碗。洗碗完成后, 再倒厨余垃圾。这里的一系列动作就涉及到了多层嵌套调用,也就是回调地狱。

关于回调地狱,我们来看看几段代码举例。

1.1、定时器的代码举例:(回调地狱)

  1. setTimeout(function () {
  2. console.log('qiangu1');
  3. setTimeout(function () {
  4. console.log('qiangu2');
  5. setTimeout(function () {
  6. console.log('qiangu3');
  7. }, 3000);
  8. }, 2000);
  9. }, 1000);

1.2、Node.js 读取文件的代码举例:(回调地狱)

  1. fs.readFile(A, 'utf-8', function (err, data) {
  2. fs.readFile(B, 'utf-8', function (err, data) {
  3. fs.readFile(C, 'utf-8', function (err, data) {
  4. fs.readFile(D, 'utf-8', function (err, data) {
  5. console.log('qianguyihao:' + data);
  6. });
  7. });
  8. });
  9. });

上面代码的逻辑为:先读取 A 文本内容,再根据 A 文本内容读取 B,然后再根据 B 的内容读取 C。为了实现这个业务逻辑,上面的代码就很容易形成回调地狱。

1.3、ajax 请求的代码举例:(回调地狱)

  1. // 伪代码
  2. ajax('a.json', (res1) => {
  3. console.log(res1);
  4. ajax('b.json', (res2) => {
  5. console.log(res2);
  6. ajax('c.json', (res3) => {
  7. console.log(res3);
  8. });
  9. });
  10. });

2、回调的写法不一致问题

  1. // Node.js 读取文件时,成功回调和失败回调,是通过 error参数来区分
  2. readFile('d:\\readme.text', function (err, data) {
  3. if (error) {
  4. console.log('文件读取失败');
  5. } else {
  6. console.log('文件读取成功');
  7. }
  8. });
  9. // jQuery的 ajax 写法中,成功回调和失败回调,是通过两个回调函数来区分
  10. $.ajax({
  11. url: '/ajax.json',
  12. success: function (response) {
  13. console.log('文件读取成功');
  14. },
  15. error: function (err) {
  16. console.log('文件读取失败');
  17. },
  18. });

我们可以看到,上面的代码中,成功回调和失败回调,写法不统一,需要单独记忆,容易出错。

小结

在 ES5 中,当进行多层嵌套回调时,会导致代码层次过多,很难进行后续维护和二次开发;而且会导致回调地狱的问题。ES6 中的 Promise 就可以解决这些问题。

当然, Promise 的强大功能,不止于此。我们来一探究竟。

Promise 的介绍和优点

ES6 中的 Promise 是异步编程的一种方案。从语法上讲,Promise 是一个对象,它可以获取异步操作的消息。

Promise 对象, 可以用同步的表现形式来书写异步代码(也就是说,代码看起来是同步的,但本质上的运行过程是异步的)。使用 Promise 主要有以下好处:

  • 1、可以很好地解决回调地狱的问题(避免了层层嵌套的回调函数)。
  • 2、语法简洁、可读性强,便于后期维护。
  • 3、Promise 对象提供了简洁的 API,使得管理异步操作更加容易。比如多任务等待合并

Promise 的伪代码结构,大概是这样的:

  1. // 伪代码1
  2. myPromise()
  3. .then(
  4. function () {},
  5. function () {}
  6. )
  7. .then(
  8. function () {},
  9. function () {}
  10. )
  11. .then(
  12. function () {},
  13. function () {}
  14. );
  15. // 伪代码2
  16. 是时候展现真正的厨艺了().然后(买菜).然后(做饭).然后(洗碗);

上面的伪代码可以看出,即便在业务逻辑上是层层嵌套,但是代码写法上,却十分优雅,也没有过多的嵌套。

Promise 对象的用法和状态

使用 Promise 的基本步骤

(1)通过 new Promise() 构造出一个 Promise 实例。Promise 的构造函数中传入一个参数,这个参数是一个函数,该函数用于处理异步任务。

(2)函数中传入两个参数:resolve 和 reject,分别表示异步执行成功后的回调函数和异步执行失败后的回调函数。代表着我们需要改变当前实例的状态到已完成或是已拒绝

(3)通过 promise.then() 和 promise.catch() 处理返回结果(这里的 promise 指的是 Promise 实例)。

看到这里,你估计还是不知道 Promise 怎么使用。我们不妨来看一下 Promise 有哪些状态,便一目了然。要知道,Promise 的精髓在于对异步操作的状态管理

promise 对象的 3 个状态

  • 初始化(等待中):pending

  • 成功:fulfilled

  • 失败:rejected

步骤 1

当 new Promise()执行之后,promise 对象的状态会被初始化为pending,这个状态是初始化状态。new Promise()这行代码,括号里的内容是同步执行的。括号里可以再定义一个 异步任务的 function,function 有两个参数:resolve 和 reject。如下:

  • 如果请求成功了,则执行 resolve(),此时,promise 的状态会被自动修改为 fulfilled。

  • 如果请求失败了,则执行 reject(),此时,promise 的状态会被自动修改为 rejected

(2)promise.then()方法:只有 promise 的状态被改变之后,才会走到 then 或者 catch。也就是说,在 new Promise()的时候,如果没有写 resolve(),则 promise.then() 不执行;如果没有写 reject(),则 promise.catch() 不执行。

then()括号里面有两个参数,分别代表两个函数 function1 和 function2:

  • 如果 promise 的状态为 fulfilled(意思是:如果请求成功),则执行 function1 里的内容

  • 如果 promise 的状态为 rejected(意思是,如果请求失败),则执行 function2 里的内容

另外,resolve()和 reject()这两个方法,是可以给 promise.then()传递参数的。

关于 promise 的状态改变,以及如何处理状态改变,伪代码及注释如下:

  1. // 创建 promise 实例
  2. let promise = new Promise((resolve, reject) => {
  3. //进来之后,状态为pending
  4. console.log('同步代码'); //这行代码是同步的
  5. //开始执行异步操作(这里开始,写异步的代码,比如ajax请求 or 开启定时器)
  6. if (异步的ajax请求成功) {
  7. console.log('333');
  8. resolve('请求成功,并传参'); //如果请求成功了,请写resolve(),此时,promise的状态会被自动修改为fulfilled(成功状态)
  9. } else {
  10. reject('请求失败,并传参'); //如果请求失败了,请写reject(),此时,promise的状态会被自动修改为rejected(失败状态)
  11. }
  12. });
  13. console.log('222');
  14. //调用promise的then():开始处理成功和失败
  15. promise.then(
  16. (successMsg) => {
  17. // 处理 promise 的成功状态:如果promise的状态为fulfilled,则执行这里的代码
  18. console.log(successMsg, '成功了'); // 这里的 successMsg 是前面的 resolve('请求成功,并传参') 传过来的参数
  19. },
  20. (errorMsg) => {
  21. //处理 promise 的失败状态:如果promise的状态为rejected,则执行这里的代码
  22. console.log(errorMsg, '失败了'); // 这里的 errorMsg 是前面的 reject('请求失败,并传参') 传过来的参数
  23. }
  24. );

上面的注释要多看几遍。

几点补充

new Promise() 是同步代码

new Promise()这行代码本身是同步的。promise 如果没有使用 resolve 或 reject 更改状态时,状态为 pending。

举例 1

  1. const promiseA = new Promise((resolve, reject) => {});
  2. console.log(promiseA); // 此时 promise 的状态为 pending(准备阶段)

上面的代码中,我既没有写 reslove(),也没有写 reject()。也就是说,这个 promise 一直处于准备阶段。

当完成异步任务之后,状态分为成功或失败,此时我们就可以用 reslove() 和 reject() 来修改 promise 的状态。

举例 2

  1. new Promise((resolve, reject) => {
  2. console.log('promise1'); // 这行代码是同步代码,会立即执行
  3. }).then((res) => {
  4. console.log('promise then:' + res); // 这行代码不会执行,因为前面没有写 resolve(),所以走不到 .then
  5. });

打印结果:

  1. promise1

上方代码,仔细看注释:如果前面没有写 resolve(),那么后面的 .then是不会执行的。

举例 3

  1. new Promise((resolve, reject) => {
  2. resolve();
  3. console.log('promise1'); // 代码1:同步任务,会立即执行
  4. }).then(res => {
  5. console.log('promise then'); // 代码2:异步任务中的微任务
  6. });
  7. console.log('千古壹号'); // 代码3:同步任务

打印结果:

  1. promise1
  2. 千古壹号
  3. promise then

代码解释:代码 1 是同步代码,所以最先执行。代码 2 是微任务里面的代码,所以要先等同步任务(代码 3)先执行完。当写完resolve();之后,就会立刻把 .then()里面的代码加入到微任务队列当中。

补充知识:异步任务分为“宏任务”、“微任务”两种。我们到后续的章节中再详细讲。

Promise 的状态一旦改变,就不能再变

代码举例:

  1. const p = new Promise((resolve, reject) => {
  2. resolve(1); // 代码执行到这里时, promise状态是 fulfilled
  3. reject(2); // 尝试修改状态为 rejected,是不行的。因为状态执行到上一行时,已经被改变了。
  4. });
  5. p.then((res) => {
  6. console.log(res);
  7. }).catch((err) => {
  8. console.log(err);
  9. });

上方代码的打印结果是 1,而不是 2,详见注释。

Promise 的状态改变,是不可逆的

小结

1、promise 有三种状态:等待中、成功、失败。等待中状态可以更改为成功或失败,已经更改过状态后⽆法继续更改(例如从失败改为成功)。

2、promise 实例中需要传⼊⼀个函数,这个函数接收两个参数,执⾏第⼀个参数之后就会改变当前 promise 为「成功」状态,执⾏第⼆个参数之后就会变为「失败」状态。

3、通过 .then ⽅法,即可在上⼀个 promise 达到成功时继续执⾏下⼀个函数或 promise。同时通过 resolve 或 reject 时传⼊参数,即可给下⼀个函数或 promise 传⼊初始值。

4、失败的 promise,后续可以通过 promise 自带的 .catch ⽅法或是 .then ⽅法的第⼆个参数进⾏捕获。

Promise 规范

Promise 是⼀个拥有 then ⽅法的对象或函数。任何符合 promise 规范的对象或函数都可以成为 Promise。

关于 promise 规范的详细解读,可以看下面这个链接:

了解这些常见概念之后,接下来,我们来具体看看 promise 的代码是怎么写的。

Promise 封装定时器

传统写法

写法 1:

  1. // 定义一个异步的延迟函数:异步函数结束1秒之后,再执行cb回调函数
  2. function fun1(cb) {
  3. setTimeout(function () {
  4. console.log('即将执行cb回调函数');
  5. cb();
  6. }, 1000);
  7. }
  8. // 先执行异步函数 fun1,再执行回调函数 myCallback
  9. fun1(myCallback);
  10. // 定义回调函数
  11. function myCallback() {
  12. console.log('我是延迟执行的cb回调函数');
  13. }

写法 2:(精简版,更常见)

  1. // 定义一个异步的延迟函数:异步函数结束1秒之后,再执行cb回调函数
  2. function fun1(cb) {
  3. setTimeout(cb, 1000);
  4. }
  5. // 先执行异步函数fun1,再执行回调函数
  6. fun1(function () {
  7. console.log('我是延迟执行的cb回调函数');
  8. });

上⾯的例⼦就是最传统的写法,在异步结束后通过传入回调函数的方式执⾏函数。

学习 Promise 之后,我们可以将这个异步函数封装为 Promise,如下。

Promise 写法

  1. function myPromise() {
  2. return new Promise((resolve) => {
  3. setTimeout(resolve, 1000);
  4. });
  5. }
  6. /* 【重要】上面的 myPromise 也可以写成:
  7. function myPromise() {
  8. return new Promise((resolve) => {
  9. setTimeout(() => {
  10. resolve();
  11. }, 1000);
  12. });
  13. }
  14. */
  15. // 先执行异步函数 myPromise,再执行回调函数
  16. myPromise().then(() => {
  17. console.log('我是延迟执行的回调函数');
  18. });

Promise 封装 Ajax 请求

传统写法

  1. // 封装 ajax 请求:传入回调函数 success 和 fail
  2. function ajax(url, success, fail) {
  3. var xmlhttp = new XMLHttpRequest();
  4. xmlhttp.open('GET', url);
  5. xmlhttp.send();
  6. xmlhttp.onreadystatechange = function () {
  7. if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
  8. success && success(xmlhttp.responseText);
  9. } else {
  10. // 这里的 && 符号,意思是:如果传了 fail 参数,就调用后面的 fail();如果没传 fail 参数,就不调用后面的内容。因为 fail 参数不一定会传。
  11. fail && fail(new Error('接口请求失败'));
  12. }
  13. };
  14. }
  15. // 执行 ajax 请求
  16. ajax(
  17. '/a.json',
  18. (res) => {
  19. console.log('qianguyihao 第一个接口请求成功:' + JSON.stringify(res));
  20. },
  21. (err) => {
  22. console.log('qianguyihao 请求失败:' + JSON.stringify(err));
  23. }
  24. );

上面的传统写法里,定义和执行 ajax 时需要传⼊ success 和 fail 这两个回调函数,进而执行回调函数。

注意看注释,callback && callback()这种格式的写法,很常见。

Promise 写法

有了 Promise 之后,我们不需要传入回调函数,而是:

  • 先将 promise 实例化;

  • 然后在原来执行回调函数的地方,改为执行对应的改变 promise 状态的函数;

  • 并通过 then … catch 或者 then …then 等写法,实现链式调用,提高代码可读性。

和传统写法相比,promise 在写法上的大致区别是:定义异步函数的时候,将 callback 改为 resolve 和 reject,待状态改变之后,我们在外面控制具体执行哪些函数。

写法 1:

  1. // 封装 ajax 请求:传入回调函数 success 和 fail
  2. function ajax(url, success, fail) {
  3. var xmlhttp = new XMLHttpRequest();
  4. xmlhttp.open('GET', url);
  5. xmlhttp.send();
  6. xmlhttp.onreadystatechange = function () {
  7. if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
  8. success && success(xmlhttp.responseText);
  9. } else {
  10. // 这里的 && 符号,意思是:如果传了 fail 参数,就调用后面的 fail();如果没传 fail 参数,就不调用后面的内容。因为 fail 参数不一定会传。
  11. fail && fail(new Error('接口请求失败'));
  12. }
  13. };
  14. }
  15. // 第一步:model层的接口封装
  16. function promiseA() {
  17. return new Promise((resolve, reject) => {
  18. ajax('xxx_a.json', (res) => {
  19. // 这里的 res 是接口的返回结果。返回码 retCode 是动态数据。
  20. if (res.retCode == 0) {
  21. // 接口请求成功时调用
  22. resolve('request success' + res);
  23. } else {
  24. // 接口请求失败时调用
  25. reject({ retCode: -1, msg: 'network error' });
  26. }
  27. });
  28. });
  29. }
  30. // 第二步:业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的,也就是从接口拿到的数据
  31. promiseA()
  32. .then((res) => {
  33. // 从 resolve 获取正常结果:接口请求成功后,打印接口的返回结果
  34. console.log(res);
  35. })
  36. .catch((err) => {
  37. // 从 reject 获取异常结果
  38. console.log(err);
  39. });

上方代码中,当从接口返回的数据data.retCode的值(接口返回码)不同时,可能会走 resolve,也可能会走 reject,这个由你自己的业务决定。

接口返回的数据,一般是{ retCode: 0, msg: 'qianguyihao' } 这种 json 格式, retCode 为 0 代表请求接口成功,所以前端对应会写if (res.retCode == 0)这样的逻辑。

另外,上面的写法中,是将 promise 实例定义成了一个函数 promiseA。我们也可以将 promise 实例定义成一个变量 promiseB,达到的效果和上面的代码是一模一样的。写法如下:(写法上略有区别)

写法 2:

  1. // 第一步:model层的接口封装
  2. const promiseB = new Promise((resolve, reject) => {
  3. ajax('xxx_a.json', (res) => {
  4. // 这里的 res 是接口的返回结果。返回码 retCode 是动态数据。
  5. if (res.retCode == 0) {
  6. // 接口请求成功时调用
  7. resolve('request success' + res);
  8. } else {
  9. // 接口请求失败时调用
  10. reject({ retCode: -1, msg: 'network error' });
  11. }
  12. });
  13. });
  14. // 第二步:业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的,也就是从接口拿到的数据
  15. promiseB
  16. .then((res) => {
  17. // 从 resolve 获取正常结果
  18. console.log(res);
  19. })
  20. .catch((err) => {
  21. // 从 reject 获取异常结果
  22. console.log(err);
  23. });

注意,如果你用的是写法 1(将 promise 实例定义为函数),则调用 promise 的时候是promiseA().then(),如果你用的是写法 2(将 promise 实例定位为函数),则调用的时候用的是promiseB.then()。写法 1 多了个括号,不要搞混了。

处理 reject 失败状态的两种写法

我们有两种写法可以捕获并处理 reject 异常状态:

  • 写法 1:通过 catch 方法捕获 状态变为已 reject 时的 promise

  • 写法 2:then 可以传两个参数,第⼀个参数为 resolve 后执⾏,第⼆个参数为 reject 后执⾏。

代码格式

这两种写法的代码格式如下:

  1. // 第一步:model层的接口封装
  2. function promiseA() {
  3. return new Promise((resolve, reject) => {
  4. // 这里做异步任务(比如 ajax 请求接口,或者定时器)
  5. ...
  6. ...
  7. });
  8. }
  9. const onResolve = function (res) {
  10. console.log(res);
  11. };
  12. const onReject = function (err) {
  13. console.log(err);
  14. };
  15. // 写法1:通过 catch 方法捕获 状态变为已拒绝时的 promise
  16. promiseA().then(onResolve).catch(onReject);
  17. // 写法2:then 可以传两个参数,第⼀个参数为 resolve 后执⾏,第⼆个参数为 reject 后执⾏
  18. promiseA().then(onResolve, onReject);
  19. // 【错误写法】写法3:通过 try catch 捕获 状态变为已拒绝时的 promise
  20. // 这种写法是错误的,因为 try catch只能捕获同步代码里的异常,而 promise.reject() 是异步代码。
  21. try {
  22. promiseA().then(onResolve);
  23. } catch (e) {
  24. // 语法上,catch必须要传入一个参数,否则报错
  25. onReject(e);
  26. }

如注释所述:前面的段落里,我们捕获 reject 异常用的就是写法 1。如果你写法 2 也是可以的。

需要注意的是,上面的写法 3 是错误的。运行之后,控制台会报如下错误:

05-Promise入门详解 - 图1

解释如下

try-catch 主要用于捕获异常,注意,这里的异常是指同步函数的异常。如果 try 里面的异步方法出现了异常,此时 catch 是无法捕获到异常的。

原因是:当异步函数抛出异常时,对于宏任务而言,执行函数时已经将该函数推入栈,此时并不在 try-catch 所在的栈,所以 try-catch 并不能捕获到错误。对于微任务而言(比如 promise)promise 的构造函数的异常只能被自带的 reject 也就是.catch 函数捕获到。

(2)写法 1 中,promiseA().then().catch()promiseA().catch().then()区别在于:前者可以捕获到 then 里面的异常,后者不可以。

代码举例

这两种写法的代码举例如下:

  1. function promiseA() {
  2. return new Promise((resolve, reject) => {
  3. // 这里做异步任务(比如 ajax 请求接口,或者定时器)
  4. ...
  5. ...
  6. });
  7. }
  8. // 写法1
  9. promiseB()
  10. .then((res) => {
  11. // 从 resolve 获取正常结果
  12. console.log('接口请求成功时,走这里');
  13. console.log(res);
  14. })
  15. .catch((err) => {
  16. // 从 reject 获取异常结果
  17. console.log('接口请求失败时,走这里');
  18. console.log(err);
  19. })
  20. .finally(() => {
  21. console.log('无论接口请求成功与否,都会走这里');
  22. });
  23. // 写法 2:(和写法 1 等价)
  24. promiseB()
  25. .then(
  26. (res) => {
  27. // 从 resolve 获取正常结果
  28. console.log('接口请求成功时,走这里');
  29. console.log(res);
  30. },
  31. (err) => {
  32. // 从 reject 获取异常结果
  33. console.log('接口请求失败时,走这里');
  34. console.log(err);
  35. }
  36. )
  37. .finally(() => {
  38. console.log('无论接口请求成功与否,都会走这里');
  39. });

代码解释:写法 1 和写法 2 的作用是完全等价的。只不过,写法 2 是把 catch 里面的代码作为 then 里面的第二个参数而已。

总结

了解这些内容之后, 你已经对 Promise 有了基本了解。下一篇文章,我们来讲一讲 Promise 在实战开发的常见用法。

参考链接

我的公众号

想学习更多技能?不妨关注我的微信公众号:千古壹号(id:qianguyihao)。

扫一扫,你将发现另一个全新的世界,而这将是一场美丽的意外:

05-Promise入门详解 - 图2