mirror of
https://github.com/qianguyihao/Web.git
synced 2024-11-02 05:54:45 +08:00
905 lines
32 KiB
JavaScript
905 lines
32 KiB
JavaScript
## 为什么需要 Promise？
|
||
|
||
我们在上一篇文章《单线程和异步》中讲过，Javascript 是⼀⻔单线程语⾔。早期我们解决异步场景时，⼤部分情况都是通过回调函数来进⾏。
|
||
|
||
（如果你还不了解单线程和异步的概念，可以先去回顾上一篇文章。）
|
||
|
||
### 回调的定义
|
||
|
||
把函数 A 传给另一个函数 B 调用，那么函数 A 就是回调函数。
|
||
|
||
例如在浏览器中发送 ajax 请求，就是常⻅的⼀个异步场景，发送请求后，需要等待一段时间，等服务端响应之后我们才能拿到结果。如果我们希望在异步结束之后执⾏某个操作，就只能通过**回调函数**这样的⽅式进⾏操作。
|
||
|
||
```js
|
||
var dynamicFunc = function (callback) {
|
||
setTimeout(function () {
|
||
callback();
|
||
}, 1000);
|
||
};
|
||
|
||
dynamicFunc(function () {
|
||
console.log('qian gu');
|
||
});
|
||
```
|
||
|
||
例如上⾯这个例⼦，dynamicFunc 就是⼀个异步函数，⾥⾯ setTimeout 会在 1s 之后调⽤传⼊的 callback 函数。按照上⾯的调⽤⽅式，最终 1s 之后，会打印 qian gu 这个结果。
|
||
|
||
为了能使回调函数以更优雅的⽅式进⾏调⽤，在 ES6 语法中，新增了⼀个名为 Promise 的新规范。
|
||
|
||
### 回调的缺点
|
||
|
||
回调的写法比较直观，不需要 return，层层嵌套即可。但也存在两个问题：
|
||
|
||
- 1、如果嵌套过深，则会出现**回调地狱**的问题。
|
||
|
||
- 2、不同的函数，回调的参数，在写法上可能不一致，导致不规范、且需要**单独记忆**。
|
||
|
||
我们来具体看看这两个问题。
|
||
|
||
**1、回调地狱的问题**：
|
||
|
||
如果多个异步函数存在依赖关系（比如，需要等第一个异步函数执行完成后，才能执行第二个异步函数；等第二个异步函数执行完毕后，才能执行第三个异步函数），就需要多个异步函数进⾏层层嵌套，⾮常不利于后续的维护，而且会导致**回调地狱**的问题。
|
||
|
||
关于回调地狱，我们来举一个形象的例子：
|
||
|
||
> 假设买菜、做饭、洗碗、倒厨余垃圾都是异步的。
|
||
|
||
> 但真实的场景中，实际的操作流程是：买菜成功之后，才能开始做饭。做饭成功后，才能开始洗碗。洗碗完成后， 再倒厨余垃圾。这里的一系列动作就涉及到了多层嵌套调用，也就是回调地狱。
|
||
|
||
关于回调地狱，我们来看看两段代码。
|
||
|
||
定时器的代码举例：（回调地狱）
|
||
|
||
```js
|
||
setTimeout(function () {
|
||
console.log('qiangu1');
|
||
setTimeout(function () {
|
||
console.log('qiangu2');
|
||
setTimeout(function () {
|
||
console.log('qiangu3');
|
||
}, 3000);
|
||
}, 2000);
|
||
}, 1000);
|
||
```
|
||
|
||
ajax 请求的代码举例：（回调地狱）
|
||
|
||
```js
|
||
// 伪代码
|
||
ajax('a.json', (res1) => {
|
||
console.log(res1);
|
||
ajax('b.json', (res2) => {
|
||
console.log(res2);
|
||
ajax('c.json', (res3) => {
|
||
console.log(res3);
|
||
});
|
||
});
|
||
});
|
||
```
|
||
|
||
**2、回调的写法不一致问题**：
|
||
|
||
```js
|
||
// Node.js 读取文件时，成功回调和失败回调，是通过 error参数来区分
|
||
readFile('d:\\readme.text', function (error, data) {
|
||
if (error) {
|
||
console.log('文件读取失败');
|
||
} else {
|
||
console.log('文件读取成功');
|
||
}
|
||
});
|
||
|
||
// jQuery的 ajax 写法中，成功回调和失败回调，是通过两个回调函数来区分
|
||
$.ajax({
|
||
url: '/ajax.json',
|
||
success: function (response) {
|
||
console.log('文件读取成功');
|
||
},
|
||
error: function (err) {
|
||
console.log('文件读取失败');
|
||
},
|
||
});
|
||
```
|
||
|
||
我们可以看到，上面的代码中，成功回调和失败回调，写法不统一，需要单独记忆，容易出错。
|
||
|
||
**小结**：
|
||
|
||
在 ES5 中，当进行多层嵌套回调时，会导致代码层次过多，很难进行后续维护和二次开发；而且会导致**回调地狱**的问题。ES6 中的 Promise 就可以解决这两个问题。
|
||
|
||
当然， Promise 的更强大功能，不止于此。我们来一探究竟。
|
||
|
||
### Promise 的介绍和优点
|
||
|
||
ES6 中的 Promise 是异步编程的一种方案。从语法上讲，Promise 是一个对象，它可以获取异步操作的消息。
|
||
|
||
Promise 对象, 可以**用同步的表现形式来书写异步代码**（也就是说，代码看起来是同步的，但本质上的运行过程是异步的）。使用 Promise 主要有以下好处：
|
||
|
||
- 可以很好地解决**回调地狱**的问题（避免了层层嵌套的回调函数）。
|
||
|
||
- 语法非常简洁、可读性强，便于后期维护。Promise 对象提供了简洁的 API，使得控制异步操作更加容易。
|
||
|
||
Promise 的伪代码结构，大概是这样的：
|
||
|
||
```js
|
||
// 伪代码1
|
||
myPromise()
|
||
.then(
|
||
function () {},
|
||
function () {}
|
||
)
|
||
.then(
|
||
function () {},
|
||
function () {}
|
||
)
|
||
.then(
|
||
function () {},
|
||
function () {}
|
||
);
|
||
|
||
// 伪代码2
|
||
是时候展现真正的厨艺了().然后(买菜).然后(做饭).然后(洗碗);
|
||
```
|
||
|
||
上面的伪代码可以看出，即便在业务逻辑上是层层嵌套，但是代码写法上，却十分优雅，也没有过多的嵌套。
|
||
|
||
## Promise 基础
|
||
|
||
### Promise 的基本用法
|
||
|
||
（1）通过 `new Promise()` 构造出一个 Promise 实例。Promise 的构造函数中传入一个参数，这个参数是一个函数，该函数用于处理异步任务。
|
||
|
||
（2）函数中传入两个参数：resolve 和 reject，分别表示异步执行成功后的回调函数和异步执行失败后的回调函数。代表着我们需要改变当前实例的状态到**已完成**或是**已拒绝**。
|
||
|
||
（3）通过 promise.then() 处理返回结果（这里的 `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()方法，括号里面有两个参数，分别代表两个函数 function1 和 function2：
|
||
|
||
- 如果 promise 的状态为 fulfilled（意思是：如果请求成功），则执行 function1 里的内容
|
||
|
||
- 如果 promise 的状态为 rejected（意思是，如果请求失败），则执行 function2 里的内容
|
||
|
||
另外，resolve()和 reject()这两个方法，是可以给 promise.then()传递参数的。
|
||
|
||
关于 promise 的状态改变，伪代码及注释如下：
|
||
|
||
```javascript
|
||
// 创建 promise 实例
|
||
let promise = new Promise((resolve, reject) => {
|
||
//进来之后，状态为pending
|
||
console.log('111'); //这行代码是同步的
|
||
//开始执行异步操作（这里开始，写异步的代码，比如ajax请求 or 开启定时器）
|
||
if (异步的ajax请求成功) {
|
||
console.log('333');
|
||
resolve('haha'); //如果请求成功了，请写resolve()，此时，promise的状态会被自动修改为fulfilled
|
||
} else {
|
||
reject('555'); //如果请求失败了，请写reject()，此时，promise的状态会被自动修改为rejected
|
||
}
|
||
});
|
||
console.log('222');
|
||
|
||
//调用promise的then()
|
||
promise.then(
|
||
(successMsg) => {
|
||
//如果promise的状态为fulfilled，则执行这里的代码
|
||
console.log(successMsg, '成功了');
|
||
},
|
||
(errorMsg) => {
|
||
//如果promise的状态为rejected，则执行这里的代码
|
||
console.log(errorMsg, '失败了');
|
||
}
|
||
);
|
||
```
|
||
|
||
**几点补充**：
|
||
|
||
（1）Promise 的状态一旦改变，就不能再变。
|
||
|
||
（2）Promise 的状态改变，是不可逆的。
|
||
|
||
为了解释这两点，我们来看个例子：
|
||
|
||
```js
|
||
const p = new Promise((resolve, reject) => {
|
||
resolve(1); // 代码执行到这里时， promise状态是 fulfilled
|
||
reject(2); // 尝试修改状态为 rejected，是不行的。因为状态执行到上一行时，已经被改变了。
|
||
});
|
||
|
||
p.then((res) => {
|
||
console.log(res);
|
||
}).catch((err) => {
|
||
console.log(err);
|
||
```
|
||
|
||
上方代码的打印结果是 1，而不是 2，详见注释。
|
||
|
||
### 小结
|
||
|
||
1、promise 有三种状态：等待中、成功、失败。等待中状态可以更改为成功或失败，已经更改过状态后⽆法继续更改（例如从失败改为成功）。
|
||
|
||
2、promise 实例中需要传⼊⼀个函数，这个函数接收两个参数，执⾏第⼀个参数之后就会改变当前 promise 为「成功」状态，执⾏第⼆个参数之后就会变为「失败」状态。
|
||
|
||
3、通过 .then ⽅法，即可在上⼀个 promise 达到成功时继续执⾏下⼀个函数或 promise。同时通过 resolve 或 reject 时传⼊参数，即可给下⼀个函数或 promise 传⼊初始值。
|
||
|
||
4、失败的 promise，后续可以通过 promise 自带的 .catch ⽅法或是 .then ⽅法的第⼆个参数进⾏捕获。
|
||
|
||
### Promise 规范
|
||
|
||
Promise 是⼀个拥有 then ⽅法的对象或函数。任何符合 promise 规范的对象或函数都可以成为 Promise。
|
||
|
||
关于 promise 规范的详细解读，可以看下面这个链接：
|
||
|
||
- Promises/A+ 规范：<https://promisesaplus.com/>
|
||
|
||
了解这些常见概念之后，接下来，我们来具体看看 promise 的代码是怎么写的。
|
||
|
||
## Promise 封装异步任务
|
||
|
||
### 传统写法
|
||
|
||
写法 1：
|
||
|
||
```js
|
||
// 定义一个异步的延迟函数：异步函数结束1秒之后，再执行cb回调函数
|
||
function fun1(cb) {
|
||
setTimeout(function () {
|
||
console.log('即将执行cb回调函数');
|
||
cb();
|
||
}, 1000);
|
||
}
|
||
|
||
// 先执行异步函数 fun1，再执行回调函数 myCallback
|
||
fun1(myCallback);
|
||
|
||
// 定义回调函数
|
||
function myCallback() {
|
||
console.log('我是延迟执行的cb回调函数');
|
||
}
|
||
```
|
||
|
||
写法 2：（精简版，更常见）
|
||
|
||
```js
|
||
// 定义一个异步的延迟函数：异步函数结束1秒之后，再执行cb回调函数
|
||
function fun1(cb) {
|
||
setTimeout(cb, 1000);
|
||
}
|
||
|
||
// 先执行异步函数fun1，再执行回调函数
|
||
fun1(function () {
|
||
console.log('我是延迟执行的cb回调函数');
|
||
});
|
||
```
|
||
|
||
上⾯的例⼦就是最传统的写法，在异步结束后通过传入回调函数的方式执⾏函数。
|
||
|
||
学习 Promise 之后，我们可以将这个异步函数封装为 Promise，如下。
|
||
|
||
### Promise 写法
|
||
|
||
```js
|
||
function myPromise() {
|
||
return new Promise((resolve) => {
|
||
setTimeout(resolve, 1000);
|
||
});
|
||
}
|
||
|
||
/* 【重要】上面的 myPromise 也可以写成：
|
||
function myPromise() {
|
||
return new Promise((resolve) => {
|
||
setTimeout(() => {
|
||
resolve();
|
||
}, 1000);
|
||
});
|
||
}
|
||
*/
|
||
|
||
// 先执行异步函数fun1，再执行回调函数
|
||
myPromise().then(() => {
|
||
console.log('我是延迟执行的回调函数');
|
||
});
|
||
```
|
||
|
||
## Promise 封装 Ajax 请求
|
||
|
||
### 传统写法
|
||
|
||
```js
|
||
// 封装 ajax 请求：传入回调函数 success 和 fail
|
||
function ajax(url, success, fail) {
|
||
var xmlhttp = new XMLHttpRequest();
|
||
xmlhttp.open('GET', url);
|
||
xmlhttp.send();
|
||
xmlhttp.onreadystatechange = function () {
|
||
if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
|
||
success(xmlhttp.responseText);
|
||
} else {
|
||
fail(new Error('接口请求失败'));
|
||
}
|
||
};
|
||
}
|
||
|
||
// 执行 ajax 请求
|
||
ajax(
|
||
'/a.json',
|
||
(res) => {
|
||
console.log('qianguyihao 第一个接口请求成功:' + JSON.stringify(res));
|
||
(err) => {
|
||
console.log('qianguyihao 请求失败:' + JSON.stringify(err));
|
||
}
|
||
);
|
||
```
|
||
|
||
上面的传统写法里，定义和执行 ajax 时需要传⼊ success 和 fail 这两个回调函数，进而执行回调函数。
|
||
|
||
### Promise 写法
|
||
|
||
有了 Promise 之后，我们不需要传入回调函数，而是：
|
||
|
||
- 先将 promise 实例化；
|
||
|
||
- 然后在原来执行回调函数的地方，改为执行对应的改变 promise 状态的函数；
|
||
|
||
- 并通过 then ... catch 或者 then ...then 等写法，实现链式调用，提高代码可读性。
|
||
|
||
和传统写法相比，promise 在写法上的大致区别是：定义异步函数的时候，将 callback 改为 resolve 和 reject，待状态改变之后，我们在外面控制具体执行哪些函数。
|
||
|
||
写法 1：
|
||
|
||
```js
|
||
const request = require('request');
|
||
|
||
// 第一步：model层的接口封装
|
||
function promiseA() {
|
||
return new Promise((resolve, reject) => {
|
||
request('xxx_a.json', (res) => {
|
||
// 这里的 res 是接口的返回结果。返回码 retCode 是动态数据。
|
||
if (res.retCode == 0) {
|
||
// 接口请求成功时调用
|
||
resolve('request success' + res);
|
||
} else {
|
||
// 接口请求失败时调用
|
||
reject({ retCode: -1, msg: 'network error' });
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// 第二步：业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的，也就是从接口拿到的数据
|
||
promiseA()
|
||
.then((res) => {
|
||
// 从 resolve 获取正常结果：接口请求成功后，打印接口的返回结果
|
||
console.log(res);
|
||
})
|
||
.catch((err) => {
|
||
// 从 reject 获取异常结果
|
||
console.log(err);
|
||
});
|
||
```
|
||
|
||
上方代码中，当从接口返回的数据`data.retCode`的值（接口返回码）不同时，可能会走 resolve，也可能会走 reject，这个由你自己的业务决定。
|
||
|
||
接口返回的数据，一般是`{ retCode: 0, msg: 'qianguyihao' }` 这种 json 格式， retCode 为 0 代表请求接口成功，所以前端对应会写`if (res.retCode == 0) `这样的逻辑。
|
||
|
||
另外，上面的写法中，是将 promise 实例定义成了一个**函数** `promiseA`。我们也可以将 promise 实例定义成一个**变量** `promiseB`，达到的效果和上面的代码是一模一样的。写法如下：（写法上略有区别）
|
||
|
||
写法 2：
|
||
|
||
```js
|
||
// 第一步：model层的接口封装
|
||
const promiseB = new Promise((resolve, reject) => {
|
||
request('xxx_a.json', (res) => {
|
||
// 这里的 res 是接口的返回结果。返回码 retCode 是动态数据。
|
||
if (res.retCode == 0) {
|
||
// 接口请求成功时调用
|
||
resolve('request success' + res);
|
||
} else {
|
||
// 接口请求失败时调用
|
||
reject({ retCode: -1, msg: 'network error' });
|
||
}
|
||
});
|
||
});
|
||
|
||
// 第二步：业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的，也就是从接口拿到的数据
|
||
promiseB
|
||
.then((res) => {
|
||
// 从 resolve 获取正常结果
|
||
console.log(res);
|
||
})
|
||
.catch((err) => {
|
||
// 从 reject 获取异常结果
|
||
console.log(err);
|
||
});
|
||
```
|
||
|
||
注意，如果你用的是写法 1（将 promise 实例定义为函数），则调用 promise 的时候是`promiseA().then()`，如果你用的是写法 2（将 promise 实例定位为函数），则调用的时候用的是`promiseB.then()`。写法 1 多了个括号，不要搞混了。
|
||
|
||
### 捕获 reject 异常状态的两种写法
|
||
|
||
我们有两种写法可以捕获并处理 reject 异常状态。这两种写法的代码举例如下：
|
||
|
||
```js
|
||
// 第一步：model层的接口封装
|
||
function promiseA() {
|
||
return new Promise((resolve, reject) => {
|
||
// 这里做异步任务（比如 ajax 请求接口，或者定时器）
|
||
...
|
||
...
|
||
});
|
||
}
|
||
|
||
const onResolve = function (res) {
|
||
console.log(res);
|
||
};
|
||
|
||
const onReject = function (err) {
|
||
console.log(err);
|
||
};
|
||
|
||
// 写法1：通过 catch 方法捕获 状态变为已拒绝时的 promise
|
||
promiseA().then(onResolve).catch(onReject);
|
||
|
||
// 写法2：then 可以传两个参数，第⼀个参数为 resolve 后执⾏，第⼆个参数为 reject 后执⾏
|
||
promiseA().then(onResolve, onReject);
|
||
|
||
// 【错误写法】写法3：通过 try catch 捕获 状态变为已拒绝时的 promise
|
||
// 这种写法是错误的，因为 try catch只能捕获同步代码里的异常，而 promise.reject() 是异步代码。
|
||
try {
|
||
promiseA().then(onResolve);
|
||
} catch (e) {
|
||
// 语法上，catch必须要传入一个参数，否则报错
|
||
onReject(e);
|
||
}
|
||
```
|
||
|
||
如注释所述：前面的段落里，我们捕获 reject 异常用的就是写法 1。如果你写法 2 也是可以的。
|
||
|
||
需要注意的是，上面的写法 3 是错误的。运行之后，控制台会报如下错误：
|
||
|
||
|
||
|
||
[解释如下](https://blog.csdn.net/xiaoluodecai/article/details/107297404)：
|
||
|
||
try-catch 主要用于捕获异常，注意，这里的异常是指**同步**函数的异常。如果 try 里面的异步方法出现了异常，此时 catch 是无法捕获到异常的。
|
||
|
||
原因是：当异步函数抛出异常时，对于宏任务而言，执行函数时已经将该函数推入栈，此时并不在 try-catch 所在的栈，所以 try-catch 并不能捕获到错误。对于微任务而言（比如 promise）promise 的构造函数的异常只能被自带的 reject 也就是.catch 函数捕获到。
|
||
|
||
（2）写法 1 中，`promiseA().then().catch()`和`promiseA().catch().then()`区别在于：前者可以捕获到 `then` 里面的异常，后者不可以。
|
||
|
||
## 链式调用：基于 Promise 处理多次 Ajax 请求【重要】
|
||
|
||
实际开发中，我们经常需要同时请求多个接口。比如说：在请求完`接口1`的数据`data1`之后，需要根据`data1`的数据，继续请求接口 2，获取`data2`；然后根据`data2`的数据，继续请求接口 3。
|
||
|
||
换而言之，现在有三个网络请求，请求 2 必须依赖请求 1 的结果，请求 3 必须依赖请求 2 的结果，如果按照往常的写法，会有三层回调，会陷入“回调地狱”。
|
||
|
||
这种场景其实就是接口的多层嵌套调用。有了 Promise 之后，我们可以把多层嵌套调用按照**线性**的方式进行书写，非常优雅。也就是说：Promise 可以把原本的**多层嵌套写法**改进为**链式写法**。
|
||
|
||
### 传统写法
|
||
|
||
```js
|
||
// 封装 ajax 请求：传入回调函数 success 和 fail
|
||
function ajax(url, success, fail) {
|
||
var xmlhttp = new XMLHttpRequest();
|
||
xmlhttp.open('GET', url);
|
||
xmlhttp.send();
|
||
xmlhttp.onreadystatechange = function () {
|
||
if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
|
||
success(xmlhttp.responseText);
|
||
} else {
|
||
fail(new Error('接口请求失败'));
|
||
}
|
||
};
|
||
}
|
||
|
||
// 执行 ajax 请求
|
||
ajax(
|
||
'/a.json',
|
||
(res) => {
|
||
console.log('qianguyihao 第一个接口请求成功:' + JSON.stringify(res));
|
||
// ajax嵌套调用
|
||
ajax('b.json', (res) => {
|
||
console.log('qianguyihao 第二个接口请求成功:' + JSON.stringify(res));
|
||
// ajax嵌套调用
|
||
ajax('c.json', (res) => {
|
||
console.log('qianguyihao 第三个接口请求成功:' + JSON.stringify(res));
|
||
});
|
||
});
|
||
},
|
||
(err) => {
|
||
console.log('qianguyihao 请求失败:' + JSON.stringify(err));
|
||
}
|
||
);
|
||
```
|
||
|
||
上面的代码层层嵌套，出现了我们常说的回调地狱问题。
|
||
|
||
### Promise 链式调用（初步写法，方便理解）
|
||
|
||
如果我们不对 Promise 的链式调用进行封装，那么，它的简单写法是下面这样的：
|
||
|
||
```js
|
||
// 封装 ajax 请求：传入回调函数 success 和 fail
|
||
function ajax(url, success, fail) {
|
||
var xmlhttp = new XMLHttpRequest();
|
||
xmlhttp.open('GET', url);
|
||
xmlhttp.send();
|
||
xmlhttp.onreadystatechange = function () {
|
||
if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
|
||
success(xmlhttp.responseText);
|
||
} else {
|
||
fail(new Error('接口请求失败'));
|
||
}
|
||
};
|
||
}
|
||
|
||
new Promise((resolve, reject) => {
|
||
ajax('a.json', (res) => {
|
||
console.log(res);
|
||
resolve();
|
||
});
|
||
})
|
||
.then((res) => {
|
||
console.log('a成功');
|
||
return new Promise((resolve, reject) => {
|
||
ajax('b.json', (res) => {
|
||
console.log(res);
|
||
resolve();
|
||
});
|
||
});
|
||
})
|
||
.then((res) => {
|
||
console.log('b成功');
|
||
return new Promise((resolve, reject) => {
|
||
ajax('c.json', (res) => {
|
||
console.log(res);
|
||
resolve();
|
||
});
|
||
});
|
||
})
|
||
.then((res) => {
|
||
cnosole.log('c成功');
|
||
});
|
||
```
|
||
|
||
上面代码中，then 是可以链式调用的，一旦 return 一个新的 promise 实例之后，后面的 then 就可以拿到前面 resolve 出来的数据。这种**扁平化**的写法，更方便维护；并且可以更好的**管理**请求成功和失败的状态。
|
||
|
||
你可能会奇怪，上面的代码，怎么这么多？而且有不少重复。这里只是采用了一种笨拙的方式来写，为的是方便大家理解 promise 的执行过程。我们其实可以对 promise 的链式调用进行进一步封装。
|
||
|
||
怎么个封装法呢？上面的代码中，每次在 return 一个 promise 的时候，只是 url 地址不一样，其他的代码是一样的。所以我们可以把重复的代码封装成函数。
|
||
|
||
### Promise 链式调用（封装写法）
|
||
|
||
封装 Ajax 请求的链式调用，代码举例：
|
||
|
||
```js
|
||
// 定义 ajax 请求：传入回调函数 success 和 fail
|
||
function ajax(url, success, fail) {
|
||
var xmlhttp = new XMLHttpRequest();
|
||
xmlhttp.open('GET', url);
|
||
xmlhttp.send();
|
||
xmlhttp.onreadystatechange = function () {
|
||
if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
|
||
success(xmlhttp.responseText);
|
||
} else {
|
||
fail(new Error('接口请求失败'));
|
||
}
|
||
};
|
||
}
|
||
|
||
// 第一步：model层，接口封装
|
||
function getPromise(url) {
|
||
return new Promise((resolve, reject) => {
|
||
ajax(url, (res) => {
|
||
// 这里的 res 是接口的返回结果。返回码 retCode 是动态数据。
|
||
if (res.retCode == 0) {
|
||
// 接口请求成功时调用
|
||
resolve('request success' + res);
|
||
} else {
|
||
// 接口请求异常时调用
|
||
reject({ retCode: -1, msg: 'network error' });
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// 第二步：业务层的接口调用。这里的 data 就是 从 resolve 和 reject 传过来的，也就是从接口拿到的数据
|
||
getPromise('a.json')
|
||
.then((res) => {
|
||
// a 请求成功。从 resolve 获取正常结果：接口请求成功后，打印a接口的返回结果
|
||
console.log(res);
|
||
return getPromise('b.json'); // 继续请求 b
|
||
})
|
||
.then((res) => {
|
||
// b 请求成功
|
||
console.log(res);
|
||
return getPromise('c.json'); // 继续请求 c
|
||
})
|
||
.then((res) => {
|
||
// c 请求成功
|
||
console.log(res);
|
||
})
|
||
.catch((e) => {
|
||
// 从 reject中获取异常结果
|
||
console.log(e);
|
||
});
|
||
```
|
||
|
||
怎么样？上面代码中，是不是非常简洁？而且可读性很强。
|
||
|
||
代码写到这里，我们还可以再继续优化一下。细心的你可以发现，我们在依次请求三个接口的时候，里面针对 resolve 和 reject 的处理时机是一样的。
|
||
|
||
但是，真正在实战中，我们在调不用的接口时，要处理的 resolve 和 reject 的时机往往是不同的。所以分开封装 不同的 Promise 实例。实战中的代码，应该是像下面这样写。
|
||
|
||
### Promise 链式调用（封装写法，实战版）
|
||
|
||
```html
|
||
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Document</title>
|
||
</head>
|
||
<body>
|
||
<script>
|
||
// 封装 ajax 请求：传入回调函数 success 和 fail
|
||
function ajax(url, success, fail) {
|
||
var xmlhttp = new XMLHttpRequest();
|
||
xmlhttp.open('GET', url);
|
||
xmlhttp.send();
|
||
xmlhttp.onreadystatechange = function () {
|
||
if (xmlhttp.readyState === 4 && xmlhttp.status === 200) {
|
||
success(xmlhttp.responseText);
|
||
} else {
|
||
fail(new Error('接口请求失败'));
|
||
}
|
||
};
|
||
}
|
||
|
||
// Promise 封装接口1
|
||
function request1() {
|
||
return new Promise((resolve, reject) => {
|
||
ajax('https://www.baidu.com', (res) => {
|
||
if (res.retCode == 201) {
|
||
// 接口请求成功时调用：这里的 res 是接口1的返回结果
|
||
resolve('request1 success' + res);
|
||
} else {
|
||
// 接口请求异常时调用异常
|
||
reject('接口1请求失败');
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// Promise 封装接口2
|
||
function request2() {
|
||
return new Promise((resolve, reject) => {
|
||
ajax('https://www.jd.com', (res) => {
|
||
if (res.retCode == 202) {
|
||
// 这里的 res 是接口2的返回结果
|
||
resolve('request2 success' + res);
|
||
} else {
|
||
reject('接口2请求失败');
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// Promise 封装接口3
|
||
function request3() {
|
||
return new Promise((resolve, reject) => {
|
||
ajax('https://www.taobao.com', (res) => {
|
||
if (res.retCode == 203) {
|
||
// 这里的 res 是接口3的返回结果
|
||
resolve('request3 success' + res);
|
||
} else {
|
||
reject('接口3请求失败');
|
||
}
|
||
});
|
||
});
|
||
}
|
||
|
||
// 先发起request1，等resolve后再发起request2；紧接着，等 request2有了 resolve之后，再发起 request3
|
||
request1()
|
||
.then((res1) => {
|
||
// 接口1请求成功
|
||
console.log(res1);
|
||
return request2();
|
||
})
|
||
.then((res2) => {
|
||
// 接口2请求成功
|
||
console.log(res2);
|
||
return request3();
|
||
})
|
||
.then((res3) => {
|
||
// 接口3请求成功
|
||
console.log(res3);
|
||
})
|
||
.catch((err) => {
|
||
// 从 reject中获取异常结果
|
||
console.log(err);
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
这段代码很经典，你一定要多看几遍。
|
||
|
||
## return 的函数返回值
|
||
|
||
return 后面的返回值，有两种情况：
|
||
|
||
- 情况 1：返回 Promise 实例对象。返回的该实例对象会调用下一个 then。
|
||
|
||
- 情况 2：返回普通值。返回的普通值会直接传递给下一个 then，通过 then 参数中函数的参数接收该值。
|
||
|
||
我们针对上面这两种情况，详细解释一下。
|
||
|
||
### 情况 1：返回 Promise 实例对象
|
||
|
||
举例如下：（这个例子，跟上一段 Ajax 链式调用 的例子差不多）
|
||
|
||
```html
|
||
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Document</title>
|
||
</head>
|
||
<body>
|
||
<script type="text/javascript">
|
||
/*
|
||
基于Promise发送Ajax请求
|
||
*/
|
||
function queryData(url) {
|
||
return new Promise((resolve, reject) => {
|
||
var xhr = new XMLHttpRequest();
|
||
xhr.onreadystatechange = function () {
|
||
if (xhr.readyState != 4) return;
|
||
if (xhr.readyState == 4 && xhr.status == 200) {
|
||
// 处理正常情况
|
||
resolve(xhr.responseText);
|
||
} else {
|
||
// 处理异常情况
|
||
reject('接口请求失败');
|
||
}
|
||
};
|
||
xhr.responseType = 'json'; // 设置返回的数据类型
|
||
xhr.open('get', url);
|
||
xhr.send(null); // 请求接口
|
||
});
|
||
}
|
||
// 发送多个ajax请求并且保证顺序
|
||
queryData('http://localhost:3000/api1')
|
||
.then(
|
||
(data1) => {
|
||
console.log(JSON.stringify(data1));
|
||
return queryData('http://localhost:3000/api2');
|
||
},
|
||
(error1) => {
|
||
console.log(error1);
|
||
}
|
||
)
|
||
.then(
|
||
(data2) => {
|
||
console.log(JSON.stringify(data2));
|
||
// 这里的 return，返回的是 Promise 实例对象
|
||
return new Promise((resolve, reject) => {
|
||
resolve('qianguyihao');
|
||
});
|
||
},
|
||
(error2) => {
|
||
console.log(error2);
|
||
}
|
||
)
|
||
.then((data3) => {
|
||
console.log(data3);
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
### 情况 2：返回 普通值
|
||
|
||
```html
|
||
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<title>Document</title>
|
||
</head>
|
||
<body>
|
||
<script type="text/javascript">
|
||
/*
|
||
基于Promise发送Ajax请求
|
||
*/
|
||
function queryData(url) {
|
||
return new Promise((resolve, reject) => {
|
||
var xhr = new XMLHttpRequest();
|
||
xhr.onreadystatechange = function () {
|
||
if (xhr.readyState != 4) return;
|
||
if (xhr.readyState == 4 && xhr.status == 200) {
|
||
// 处理正常情况
|
||
resolve(xhr.responseText);
|
||
} else {
|
||
// 处理异常情况
|
||
reject('接口请求失败');
|
||
}
|
||
};
|
||
xhr.responseType = 'json'; // 设置返回的数据类型
|
||
xhr.open('get', url);
|
||
xhr.send(null); // 请求接口
|
||
});
|
||
}
|
||
// 发送多个ajax请求并且保证顺序
|
||
queryData('http://localhost:3000/api1')
|
||
.then(
|
||
(data1) => {
|
||
console.log(JSON.stringify(data1));
|
||
return queryData('http://localhost:3000/api2');
|
||
},
|
||
(error1) => {
|
||
console.log(error1);
|
||
}
|
||
)
|
||
.then(
|
||
(data2) => {
|
||
console.log(JSON.stringify(data2));
|
||
// 返回普通值
|
||
return 'qianguyihao';
|
||
},
|
||
(error2) => {
|
||
console.log(error2);
|
||
}
|
||
)
|
||
/*
|
||
既然上方返回的是 普通值，那么，这里的 then 是谁来调用呢？
|
||
答案是：这里会产生一个新的 默认的 promise实例，来调用这里的then，确保可以继续进行链式操作。
|
||
*/
|
||
.then((data3) => {
|
||
// 这里的 data3 接收的是 普通值 'qianguyihao'
|
||
console.log(data3);
|
||
});
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
## 总结
|
||
|
||
了解这些内容之后， 你已经对 Promise 有了基本了解。下一篇文章，我们来讲一讲 Promise 在实战开发的常见用法。
|
||
|
||
## 参考链接
|
||
|
||
- [当面试官问你 Promise 的时候，他究竟想听到什么？](https://zhuanlan.zhihu.com/p/29235579)
|
||
|
||
- [手写一个 Promise/A+,完美通过官方 872 个测试用例](https://www.cnblogs.com/dennisj/p/12660388.html)
|
||
|
||
## 我的公众号
|
||
|
||
想学习**代码之外的技能**？不妨关注我的微信公众号：**千古壹号**（id：`qianguyihao`）。
|
||
|
||
扫一扫，你将发现另一个全新的世界，而这将是一场美丽的意外：
|
||
|
||
|