Promise【一篇搞懂】

大家好，欢迎来到IT知识分享网。

1. Promise 的理解

1.1 定义

MDN 上的定义：一个 Promise 对象代表一个在这个 Promise 被创建出来时不一定已知的值。它让您能够 把异步操作最终的成功返回值或者失败原因和相应的处理程序关联起来。 这样使得异步方法可以像同步方法那样返回值：异步方法并不会立即返回最终的值，而是会返回一个 promise，以便在未来某个时候把值交给使用者。

• 抽象表达：Promise 是 ES6 引入的异步编程的新解决方案。在 Promise 出现之前，只是单纯的使用回调函数。
• 具体表达：Promise 是一个构造函数，由 Promise 产生的对象用来封装一个异步操作，并且可以获取其成功/失败的最终结果。

1.2 Promise 的状态

一个 Promise 必然处于以下几种状态之一：

• 待定（pending）: 初始状态，既没有被兑现，也没有被拒绝。
• 成功（fulfilled）: 意味着操作成功完成。
• 失败（rejected）: 意味着操作失败。

一个 Promise 的状态只能由 pending 变为 fulfilled，或者变为 rejected，且只能改变一次。

链式调用：Promise 对象具有 then 和 catch 方法来处理下一步的操作。因为 Promise.prototype.then 和 Promise.prototype.catch 方法返回的是 Promise，所以它们可以被链式调用。

1.3 Promise 的基本流程

一个 Promise 对象刚被创建时的初始状态为 pending。接下来会执行异步操作，若异步操作成功，则执行 resolve() 函数，可将成功返回的数据通过 resolve(data) 返回。若异步操作失败，则执行 reject() 函数，将失败的信息返回。

无论成功还是失败，返回的都是 Promise 对象，具有 then() 和 catch() 方法。

返回的 Promise 使用 then() 调用：

promise.then(successCallback, failureCallback);

其中，successCallback 是成功的回调函数，failureCallback 是失败的回调函数。一般格式为：

promise.then(value=>{}, reason=>{})

1.4 Promise 的基本使用

构造函数 Promise()内部自动执行一个 执行器函数，也叫 executor。这个执行器函数又接收两个参数，第一个为执行成功的回调函数（resolve），第二个为操作成功的回调函数（reject）。

需要注意，executor 执行器函数是同步回调函数。 例如有以下代码：

new Promise(// 执行器函数开始(resolve, reject) => { console.log(1)// 异步操作setTimeout(() => { console.log(2)}, 0) console.log(3)}) console.log(4) 

打印结果是：1、3、4、2

基本使用流程

const promise = new Promise((resolve, reject) => { // 执行异步操作 // 操作成功，可将数据传入 resolve(data) // 操作失败，可将错误信息传入 reject(err_msg) }) // 处理返回结果 promise.then( // 操作成功的回调 value => { }, // 操作失败的回调 reason => { } ) 

具体例子如下：

// 1. 创建 Promise 对象，此时为 pending 状态 const promise = new Promise((resolve, reject) => { // 2. 执行异步操作，这里是定时器函数setTimeout(() => { let time = Date.now() if (time % 2 === 1) { // 2.1 假定 time 为奇数时为操作成功，则执行 resolve resolve('成功的值：' + time) } else { // 2.1 假定 time 为偶时为操作失败，则执行 reject reject('失败的值：' + time)}}, 1000) }) // 3. promise 能指定成功或失败的回调函数来获取成功的 value，或失败的 reason promise.then( // 3.1 操作成功（resolve）的回调函数 value => { console.log(value) }, // 3.1 操作失败哦（reject）的回调函数 reason => { console.log(reason)} ) 

2. 为什么要使用 Promise

原因：

• 指定回调函数的方式更加灵活
• 支持链式调用，解决回调地狱问题

2.1 指定回调函数的方式更加灵活

• 在出现 Promise 以前，纯回调方式：在启动异步任务的同时，必须先指定好回调函数，否则会拿不到数据。
• Promise：启动异步任务 => 返回 Promise 对象 => 给 promise 绑定回调函数。甚至可以在异步任务结束后再指定回调函数，而这在单纯的回调方式中是不行的。

下面举例说明。

2.1.1 MDN 上的例子

使用 MDN 上的例子：假设现在有一个名为 createAudioFileAsync() 的函数，它接收一些配置和两个回调函数，然后异步地生成音频文件。一个回调函数在文件成功创建时被调用，另一个则在出现异常时被调用。创建一个文件需要一些时间，因此是一个异步回调。

参考：使用 Promise – JavaScript | MDN

// 成功的回调函数function successCallback(result) { console.log("声音文件创建成功: " + result);} // 失败的回调函数function failureCallback(error) { console.log("声音文件创建失败: " + error);}

传统的纯回调方式，需要先指定好成功和失败的回调函数。也就是说，在文件创建的结果出来之前，回调函数必须先指定好，否则文件的结果无法处理。

createAudioFileAsync(audioSettings, successCallback, failureCallback)

对于 Promise，无需考虑这方面。在启动异步任务之前或者之后，都可以指定好回调函数。这样，异步任务指定回调函数的方式就更加灵活了。

const promise = createAudioFileAsync(audioSettings); promise.then(successCallback, failureCallback);

2.1.2 实际例子

上述说明比较抽象，下面来一个实际情况的例子。

假如现在有一个 ajax 请求，获取服务器的某用户的名字。从发出请求到获得结果需要花费一些时间，这里使用定时器模拟请求。

function success(name) { console.log('成功：' + name) } function failure(msg) { console.log('失败：' + msg) }

传统纯回调方式

function ajax(success, failure) { setTimeout(() => { // 这里可以假设获取数据成功或失败 success('peter') }, 1000)} // 在启动异步任务的同时，必须先指定好 success 和 failure ajax(success, failure) // 输出：peter

Promise 方式

const promise = new Promise((resolve, reject) => { // 模拟 ajax 请求，1s后获取到数据 setTimeout(() => { resolve('peter') }, 1000)}) // 此时异步任务已启动，不必先指定回调

可以在异步任务启动之后，在指定好回调函数

promise.then(value => { success(value) }, reason => { failure(reason) })// 输出：peter

甚至可以在异步任务完成后指定。请求在 1s 完成，而指定回调队列在 2s 完成。

setTimeout(() => { promise.then(value => { success(value) }, reason => {failure(reason) }) }, 2000) // 输出：peter

2.2 支持链式调用，解决回调地狱问题

2.2.1 回调地狱

回调地狱：回调函数嵌套调用，外部回调函数异步执行的结果是嵌套的回调函数执行的条件。 回调地狱的缺点：不便于阅读，不便于异常处理。

开发中经常会遇到多重异步操作，就会出现下面的写法（伪代码）：

doSomething(function(result) { doSomethingElse(result, function(newResult) { doThirdThing(newResult, function(finalResult) { console.log('Got the final result: ' + finalResult); }, failureCallback); }, failureCallback); }, failureCallback);

例如，现在要获取一个用户所有的商品数据，首先要根据用户名获取用户ID，然后根据ID获取订单信息，根据订单信息获取商品信息。一共要发起三次请求，前面的请求结果是后面请求的条件。

2.2.2 链式调用，解决回调地狱

一个 Promise 对象具有 then 和 catch 方法，而 then 和 catch 的返回结果依然是一个 Promise 对象，因此可以使用 . 符号进行链式调用。

对于上述伪代码，使用 Promise的形式改写如下：

// 把回调绑定到返回的 Promise 上，形成一个 Promise 链 doSomething().then(function(result) { return doSomethingElse(result); }).then(function(newResult) { return doThirdThing(newResult); }).then(function(finalResult) { console.log('Got the final result: ' + finalResult); }).catch(failureCallback);

链式调用格式：

const p = new Promise(resolve=>{}, reject=>{}); p.then(value=>{}, reason=>{}) .then(value=>{}, reason=>{}) .then(value=>{}, reason=>{})

2.3 终极方案：使用 async/await

Promise 链式调用已经解决了回调地狱函数层层嵌套的问题了，还需要解决什么问题么？没错，我们还要砍掉 Promise 的回调函数，回调函数太多，代码写的很长。

async/await 是 ES8 出的一个更加优雅的异步编程解决方案，它可以让异步操作代码变得像同步代码一样，看起来非常优雅而直观。

上述例子，使用 async/await 改写的形式：

async function request() { try { const result = await doSomething() const newResult = await doSomethingElse(result) const finalResult = await doThirdThing(newResult) console.log('Got the final result: ' + finalResult); } catch (error) { failureCallback(error) } }

3. 如何使用 Promise

3.1 Promise API

1. Promise 构造函数

Promise 构造函数接收一个执行器 executor，来启动这个 Promise。

new Promise(executor)

这个 executor 执行器函数又接收两个参数 resolve 和 reject，分别表示操作成功和操作失败。

new Promise((resolve, reject) => {resolve()// reject()})

• executor 函数：执行器 (resolve, reject) => { }
• resolve 函数：内部定义成功时我们调用的函数 value => {}
• reject 函数：内部定义失败时我们调用的函数 reason => {}

Tip

executor 会在 Promise 内部立即同步调用，而异步操作则在 executor 执行器中执行。

2. Promise.prototype.then()

Promise.prototype.then 方法绑定在原型 prototype 上，意味着这是一个实例方法，必须在实例对象上才能使用。该方法返回的结果依然是一个 Promise 对象，意味着我们可以进行链式调用。

语法：

p.then(onFulfilled, onRejected); p.then(value => { // fulfillment }, reason => { // rejection });

参数：

• onFulfilled 函数：成功的回调函数 (value) => {}
• onRejected 函数：失败的回调函数 (reason) => {}

返回值： 如果 then 中的回调函数：

• 返回了一个值，那么 then 返回的 Promise 将会成为接受状态（fulfilled），并且将返回的值作为接受状态的回调函数的参数值。
• 没有返回任何值，那么 then 返回的 Promise 将会成为接受状态（fulfilled），并且该接受状态的回调函数的参数值为 undefined。
• 抛出一个错误，那么 then 返回的 Promise 将会成为拒绝状态（rejected），并且将抛出的错误作为拒绝状态的回调函数的参数值。
• 返回一个已经是接受状态（fulfilled）的 Promise，那么 then 返回的 Promise 也会成为接受状态，并且将那个 Promise 的接受状态的回调函数的参数值作为该被返回的Promise的接受状态回调函数的参数值。
• 返回一个已经是拒绝状态（rejected）的 Promise，那么 then 返回的 Promise 也会成为拒绝状态，并且将那个 Promise 的拒绝状态的回调函数的参数值作为该被返回的Promise的拒绝状态回调函数的参数值。
• 返回一个未定状态（pending）的 Promise，那么 then 返回 Promise 的状态也是未定的，并且它的终态与那个 Promise 的终态相同；同时，它变为终态时调用的回调函数参数与那个 Promise 变为终态时的回调函数的参数是相同的。

Tip

参考MDN链接：Promise.prototype.then() – JavaScript | MDN

3. Promise.prototype.catch()

catch() 方法返回一个 Promise，并且处理操作失败的情况。它的行为与调用 Promise.prototype.then(undefined, onRejected) 相同。但是用起来更方便了，可以看作是一种 语法糖（让我们执行某些操作更加方便简洁的方法）。

语法：

p.catch(onRejected); p.catch(reason => { // 操作失败 });

等同于：

p.then(undefined, onFulfilled); p.then(undefined, reason => { // 操作失败 })

参数：

• onRejected：操作失败时的回调函数 (reason) => {}

返回值：

• 返回一个 Promise 对象。如果 onRejected 抛出一个错误或返回一个本身失败的 Promise，那么 catch() 返回的 Promise 的状态为 rejected；否则，状态为 fulfilled。

4. Promise.resolve()

Promise.resolve() 是一个函数对象方法，意味着只能用在函数对象 Promise 上。它接收一个 value 参数，返回一个这个给定值解析后的 Promise 对象。

语法：

Promise.resolve(value

参数：

• value：被解析的参数，可以是一个值，也可以是一个 Promise 对象，或者是一个 thenable

返回结果：

• 若给定值为一个普通数、字符串或数组等等之类的，则返回一个成功的 Promise
• 若参数本身就是一个 Promise 对象，则直接返回这个 Promise 对象。
• 由此可知，resolve() 方法可以返回一个成功或者失败的 Promise 对象

5. Promise.reject()

Promise.reject() 方法返回一个失败的 Promise 对象，接收一个 value 参数，表示失败的原因。

语法：

Promise.reject(reason);

参数：

• reason：表示操作失败的原因

返回值：

• 返回一个失败（状态为 rejected ）的 Promise 对象

6. Promise.all()

Promise.all() 方法接收由多个 promise 组成的可迭代类型（Array、Map、Set等），然后返回一个新的 promise。它等待所有 promise 完成，或者第一个失败的 promise。

Promise.all(iterable); Promise.all(promise1, promise2, ...) const p = Promise(promise1, promise2) p.then(values=>)

参数：

• iterable：可迭代类型，一般为数组

返回值：

• 若传入的参数为空的可迭代对象，例如 Promise.all([])，则返回一个已完成状态（fulfilled）的 Promise
• 若传入的参数不包含任何 promise，则返回一个异步完成（asynchronously resolved）的 Promise。例如 Promise.all([1, 2])
• 其它情况下返回一个处理中（pending）的 Promise。只有接收的参数的 promise 全部成功，这个返回的 Promise 才会是成功的，只要有一个失败，则返回一个失败的 Promise，且返回的值为第一个失败的值。
• 若所有 promise 都成功，则返回的 Promise 的值为一个包含了多个结果的数组

Promise.all 的同步与异步：

• 当如果传入的可迭代对象是空的，就是同步；其他情况都是异步。

举例: 参数为非空的数组，异步的：

const p = Promise.all([1]) setTimeout(() => { console.log(p)}) console.log('同步代码') console.log(p) // (1) // 输出： // 同步代码 // Promise {<pending>} // Promise {<fulfilled>: Array(1)}

注意：此时（1）输出状态为 pending，因为同步代码先执行，而此时异步 promise 的结果还未知

参数为空数组，同步的：

const p1 = Promise.all([]) setTimeout(() => { console.log(p1) }) console.log('同步代码') console.log(p1) // （1） // 输出 // 同步代码 // Promise {<fulfilled>: Array(0)} // Promise {<fulfilled>: Array(0)}

注意：此时（1）输出状态为 fulfilled，说明此时 Promise.all 是同步的。

Promise.all 方法举例

// 参数为空的数组 const p1 = Promise.all([]) // 参数为不包含 promise 的数组 const p2 = Promise.all([1, 2, 3]) // 参数为全部是成功的 promise 的数组 let pm1 = Promise.resolve(1) let pm2 = Promise.resolve(2) let pm3 = Promise.resolve(3) const p3 = Promise.all([pm1, pm2, pm3]) // 结果 setTimeout(() => { console.log(p1) console.log(p2) console.log(p3) // Promise {<fulfilled>: Array(0)} // Promise {<fulfilled>: Array(3)} // Promise {<fulfilled>: Array(3)}}) // 参数为包含失败的 promise 的数组 let pe1 = Promise.resolve(1) let pe2 = Promise.reject('error') let pe3 = Promise.resolve(3) const p4 = Promise.all([pe1, pe2, pe3]) setTimeout(() => { console.log(p4)}) // 输出 // Promise {<rejected>: 'error'}

7. Promise.race()

Promise.race() 也是接收一个可迭代类型，例如一个包含了多个 promise 的数组。然后返回一个新的 promise，第一个完成的 promise 的结果状态就是最终返回的结果状态。

需要注意，这里最终返回的结果的状态不一定是参数数组中位于前面的 promise，具体要看哪一个最先完成，所以 race() 方法的返回结果可能为成功或失败的。

语法：

Promise.race(iterable);

参数：

• iterable：可迭代对象，一般为包含多个 promise 的数组

返回值：

• 返回一个 promise，只要给定的可迭代对象中的 promise 有一个先完成（成功或失败），就采用它的值作为最终 promise 的值，状态与这个完成的 promise 相同。

Promise.race 的异步性（没有同步性）：

const p = Promise.race([Promise.resolve(10), Promise.resolve(20)]) // 立即输出p，此时p状态为 pending console.log(p) setTimeout(() => { // 等栈中代码执行完毕之后执行，可得到完成的promise console.log('the stack is now empty'); console.log(p) }) // 输出： // Promise { <state>: "pending" } // the stack is now empty // Promise { <state>: "fulfilled", <value>: 33 }

3.2 Promise 的几个关键问题

1. 如何改变 Promise 的状态？

• resolve(value)：如果当前是 pending 就会变为 resolved
• reject(reason)：如果当前是 pending 就会变为 rejected
• 抛出异常：如果当前是 pending 就会变为 rejected

2. 一个promise指定多个成功/失败回调函数，都会调用吗?

当 promise 改变为对应状态时都会调用。

let p = new Promise((resolve, reject) => {throw 100}) p.then(value => { },reason => { console.log('reason1 ' + reason)}) p.then(value => { },reason => { console.log('reason2 ' + reason)}) // 输出// reason1 100// reason2 100

3. 改变 promise 状态和指定回调函数谁先谁后？

1. 都有可能，正常情况下是先指定回调再改变状态，但也可以先改状态再指定回调
2. 如何先改状态再指定回调?
   1. 在执行器中直接调用 resolve()/reject()
   2. 延迟更长时间才调用 then()
3. 什么时候才能得到数据?
   1. 如果先指定的回调，那当状态发生改变时，回调函数就会调用，得到数据
   2. 如果先改变的状态，那当指定回调时，回调函数就会调用，得到数据

// 正常情况，先指定回调再改变状态 const p2 = new Promise((resolve, reject) => { // setTimeout 第三个参数，该参数将传入第一个函数参数 setTimeout(resolve, 1000, '成功的数据') // 后改变数据，同时传入值 }).then( // 先指定回调函数，保存当前回调函数 value => { console.log(value)}) // 先改状态，在指定回调函数 const p1 = new Promise((resolve, reject) => { resolve(100) // 先改变数据，同时传入值}).then( // 后指定回调函数，异步执行回调函数 value => { console.log(value)})

Tip

注意：new Promise(executor) 中的执行器以及 .then、.catch 都是同步的，但是执行器中的异步操作是异步的，.then 和 .catch 中的回调函数也是异步的。

4. promise.then() 返回的新promise 的结果状态由什么决定？

• 简单表达：由 then() 指定的回调函数执行的结果决定
• 详细表达：
  • 如果抛出异常，新 promise 变为 rejected, reason为抛出的异常
  • 如果返回的是非 promise 的任意值，新promise变为 resolved，value 为返回的值
  • 如果返回的是另一个新 promise，此 promise 的结果就会成为新 promise 的结果

5. promise 如何串连多个操作任务?

• promise的 then() 返回一个新的 promise，可以看成 then() 的链式调用
• 通过 then 的 链式调用串连多个同步/异步任务

Tip

.then() 中可以处理同步任务，也可以处理异步任务。处理异步任务时需要新创建一个 Promise。

// 任务1 const p = new Promise((resolve, reject) => { setTimeout(resolve, 0, '任务1的数据(异步)') }) p.then( value => { console.log(value) // 任务2（同步） return '任务2的数据(同步)'}, reason => { console.log(reason) }, ).then(value => { // 任务3（异步） return new Promise((resolve, reject) => { console.log(value) setTimeout(reject, 0, '任务3的错误信息(异步)') }) },reason => { console.log(reason) }).catch(reason => { console.log(reason)}) // 输出 // 任务1的数据(异步) // 任务2的数据(同步) // 任务3的错误信息(异步)

6. 异常传透

在 Promise 的链式调用链中，当所有的 .then 中都没有指定错误处理的回调，则前面出现的异常会在最后失败的回调中处理。

new Promise((resolve, reject) => { reject(1) }).then( value => { console.log(value) }).then( value => { console.log(value) }).catch(reason => { console.log('异常：' + reason) })

注意：

• .catch 所谓的异常穿透并不是一次失败状态就触发 catch，而是一层一层的传递下来的
• 异常穿透的前提条件是所有的 .then 都没有指定失败状态的回调函数。
• 如果 .catch 前的所有 .then 都指定了失败状态的回调函数，.catch 就失去了意义。

7. 值传透

值穿透指的是，链式调用的参数不是函数时，会发生值穿透，就传入的非函数值忽略，传入的是之前的函数参数。

Promise.resolve(1) .then(2) .then(Promise.resolve(3)) .then(console.log) // 1

只有传入的是函数才会传递给下一个链式调用。

Promise.resolve(1) .then(2) .then(() => 3) .then(4) .then(console.log) // 3

Promise.resolve(1) .then(function () { return 2 }) .then(() => { Promise.resolve(3) }) // 没有返回值，默认 undefined .then(4) .then(console.log) // undefined

8. 中断 Promise 链

• 什么是中断：当使用 promise 的 then 链式调用时，在中间中断，不再调用后面的回调函数
• 中断的方法：在回调函数中返回一个 pendding 状态的 promise 对象

如何返回一个 pendding 状态的 promise 对象：

return new Promise(() => { }) // pending

或者使用 Promise.race([])，race 方法接收一个空的可迭代对象时，该 Promise 会一直处于 pendding 状态。

return Promise.race([]) // pending

中断之前：

Promise.resolve(1) .then(value => { console.log(value) // 1 }) // 下面都会打印 .then(value => console.log(value)) // undefined .then(value => console.log(value)) // undefined

中断之后：

Promise.resolve(1).then(value => { console.log(value) // 1 // 返回一个 pending 状态的 promise 来中断这个调用链 return new Promise(() => { }) // 或者：return Promise.race([]) }) // 下面都不会打印 .then(value => console.log(value)) .then(value => console.log(value))