带你写出符合Promise/A+ 规范Promise的源码

 Promise是前端面试中的高频问题,如果你能根据PromiseA+的规范,写出符合规范的源码,那么我想,对于面试中的Promise相关的问题,都能够给出比较完美的答案。

我的建议是,对照规范多写几次实现,也许第一遍的时候,是改了多次,才能通过测试,那么需要反复的写,我已经将Promise的源码实现写了不下七遍,不那么聪明的话,当然需要更加努力啦~

Promise的源码实现

 
 
 
  1. /**  
  2.  * 1. new Promise时,需要传递一个 executor 执行器,执行器立刻执行  
  3.  * 2. executor 接受两个参数,分别是 resolve 和 reject 
  4.  * 3. promise 只能从 pending 到 rejected, 或者从 pending 到 fulfilled  
  5.  * 4. promise 的状态一旦确认,就不会再改变  
  6.  * 5. promise 都有 then 方法,then 接收两个参数,分别是 promise 成功的回调 onFulfilled,   
  7.  *      和 promise 失败的回调 onRejected  
  8.  * 6. 如果调用 then 时,promise已经成功,则执行 onFulfilled,并将promise的值作为参数传递进去。  
  9.  *      如果promise已经失败,那么执行 onRejected, 并将 promise 失败的原因作为参数传递进去。  
  10.  *      如果promise的状态是pending,需要将onFulfilled和onRejected函数存放起来,等待状态确定后,再依次将对应的函数执行(发布订阅)  
  11.  * 7. then 的参数 onFulfilled 和 onRejected 可以缺省  
  12.  * 8. promise 可以then多次,promise 的then 方法返回一个 promise  
  13.  * 9. 如果 then 返回的是一个结果,那么就会把这个结果作为参数,传递给下一个then的成功的回调(onFulfilled)  
  14.  * 10. 如果 then 中抛出了异常,那么就会把这个异常作为参数,传递给下一个then的失败的回调(onRejected)  
  15.  * 11.如果 then 返回的是一个promise,那么会等这个promise执行完,promise如果成功,  
  16.  *   就走下一个then的成功,如果失败,就走下一个then的失败  
  17.  */  
  18. const PENDING = 'pending';  
  19. const FULFILLED = 'fulfilled';  
  20. const REJECTED = 'rejected';  
  21. function Promise(executor) {  
  22.     let self = this;  
  23.     self.status = PENDING;  
  24.     self.onFulfilled = [];//成功的回调  
  25.     self.onRejected = []; //失败的回调  
  26.     //PromiseA+ 2.1  
  27.     function resolve(value) {  
  28.         if (self.status === PENDING) {  
  29.             self.status = FULFILLED;  
  30.             self.value = value;  
  31.             self.onFulfilled.forEach(fn => fn());//PromiseA+ 2.2.6.1  
  32.         }  
  33.     }  
  34.     function reject(reason) {  
  35.         if (self.status === PENDING) {  
  36.             self.status = REJECTED;  
  37.             self.reason = reason;  
  38.             self.onRejected.forEach(fn => fn());//PromiseA+ 2.2.6.2  
  39.         } 
  40.      } 
  41.     try {  
  42.         executor(resolve, reject);  
  43.     } catch (e) {  
  44.         reject(e);  
  45.     }  
  46. }  
  47. Promise.prototype.then = function (onFulfilled, onRejected) {  
  48.     //PromiseA+ 2.2.1 / PromiseA+ 2.2.5 / PromiseA+ 2.2.7.3 / PromiseA+ 2.2.7.4  
  49.     onFulfilled = typeof onFulfilled === 'function' ? onFulfilled : value => value;  
  50.     onRejected = typeof onRejected === 'function' ? onRejected : reason => { throw reason };  
  51.     let self = this;  
  52.     //PromiseA+ 2.2.7  
  53.     let promise2 = new Promise((resolve, reject) => {  
  54.         if (self.status === FULFILLED) {  
  55.             //PromiseA+ 2.2.2  
  56.             //PromiseA+ 2.2.4 --- setTimeout  
  57.             setTimeout(() => {  
  58.                 try {  
  59.                     //PromiseA+ 2.2.7.1  
  60.                     let x = onFulfilled(self.value);  
  61.                     resolvePromise(promise2, x, resolve, reject);  
  62.                 } catch (e) {  
  63.                     //PromiseA+ 2.2.7.2  
  64.                     reject(e);  
  65.                 }  
  66.             });  
  67.         } else if (self.status === REJECTED) {  
  68.             //PromiseA+ 2.2.3  
  69.             setTimeout(() => {  
  70.                 try {  
  71.                     let x = onRejected(self.reason);  
  72.                     resolvePromise(promise2, x, resolve, reject);  
  73.                 } catch (e) {  
  74.                     reject(e);  
  75.                 }  
  76.             });  
  77.         } else if (self.status === PENDING) {  
  78.             self.onFulfilled.push(() => {  
  79.                 setTimeout(() => {  
  80.                     try {  
  81.                         let x = onFulfilled(self.value);  
  82.                         resolvePromise(promise2, x, resolve, reject);  
  83.                     } catch (e) {  
  84.                         reject(e);  
  85.                     }  
  86.                 });  
  87.             });  
  88.             self.onRejected.push(() => {  
  89.                 setTimeout(() => {  
  90.                     try {  
  91.                         let x = onRejected(self.reason);  
  92.                         resolvePromise(promise2, x, resolve, reject);  
  93.                     } catch (e) {  
  94.                         reject(e);  
  95.                     }  
  96.                 });  
  97.             });  
  98.         }  
  99.     });  
  100.     return promise2;  
  101. }  
  102. function resolvePromise(promise2, x, resolve, reject) {  
  103.     let self = this;  
  104.     //PromiseA+ 2.3.1  
  105.     if (promise2 === x) {  
  106.         reject(new TypeError('Chaining cycle'));  
  107.     }  
  108.     if (x && typeof x === 'object' || typeof x === 'function') {  
  109.         let used; //PromiseA+2.3.3.3.3 只能调用一次  
  110.         try {  
  111.             let then = x.then;  
  112.             if (typeof then === 'function') {  
  113.                 //PromiseA+2.3.3  
  114.                 then.call(x, (y) => {  
  115.                     //PromiseA+2.3.3.1  
  116.                     if (used) return;  
  117.                     used = true;  
  118.                     resolvePromise(promise2, y, resolve, reject);  
  119.                 }, (r) => {  
  120.                     //PromiseA+2.3.3.2  
  121.                     if (used) return;  
  122.                     used = true;  
  123.                     reject(r);  
  124.                 });  
  125.             }else{  
  126.                 //PromiseA+2.3.3.4  
  127.                 if (used) return;  
  128.                 used = true;  
  129.                 resolve(x);  
  130.             }  
  131.         } catch (e) {  
  132.             //PromiseA+ 2.3.3.2  
  133.             if (used) return;  
  134.             used = true;  
  135.             reject(e);  
  136.         }  
  137.     } else {  
  138.         //PromiseA+ 2.3.3.4  
  139.         resolve(x);  
  140.     }  
  141. }  
  142. module.exports = Promise; 

有专门的测试脚本可以测试所编写的代码是否符合PromiseA+的规范。

首先,在promise实现的代码中,增加以下代码:

 
 
 
  1. PromisePromise.defer = Promise.deferred = function () {  
  2.     let dfd = {};  
  3.     dfd.promise = new Promise((resolve, reject) => {  
  4.         dfd.resolve = resolve;  
  5.         dfd.reject = reject;  
  6.     });  
  7.     return dfd;  

安装测试脚本:

 
 
 
  1. npm install -g promises-aplus-tests 

如果当前的promise源码的文件名为promise.js

那么在对应的目录执行以下命令:

 
 
 
  1. promises-aplus-tests promise.js 

promises-aplus-tests中共有872条测试用例。以上代码,可以完美通过所有用例。

对上面的代码实现做一点简要说明(其它一些内容注释中已经写得很清楚):

  1.  onFulfilled 和 onFulfilled的调用需要放在setTimeout,因为规范中表示: onFulfilled or onRejected must not be called until the execution context stack contains only platform code。使用setTimeout只是模拟异步,原生Promise并非是这样实现的。

      2.  在 resolvePromise 的函数中,为何需要usedd这个flag,同样是因为规范中明确表示: If both resolvePromise and rejectPromise are called, or multiple calls to the same argument are made, the first call takes precedence, and any further calls are ignored. 因此我们需要这样的flag来确保只会执行一次。

      3.  self.onFulfilled 和 self.onRejected 中存储了成功的回调和失败的回调,根据规范2.6显示,当promise从pending态改变的时候,需要按照顺序去指定then对应的回调。

PromiseA+的规范(翻译版)

PS: 下面是我翻译的规范,供参考

术语

  1.   promise 是一个有then方法的对象或者是函数,行为遵循本规范
  2.   thenable 是一个有then方法的对象或者是函数
  3.   value 是promise状态成功时的值,包括 undefined/thenable或者是 promise
  4.   exception 是一个使用throw抛出的异常值
  5.   reason 是promise状态失败时的值

 要求

2.1 Promise States

Promise 必须处于以下三个状态之一: pending, fulfilled 或者是 rejected

2.1.1 如果promise在pending状态

 
 
 
  1. 2.1.1.1 可以变成 fulfilled 或者是 rejected 

2.1.2 如果promise在fulfilled状态

 
 
 
  1. 2.1.2.1 不会变成其它状态  
  2. 2.1.2.2 必须有一个value值 

2.1.3 如果promise在rejected状态

 
 
 
  1. 2.1.3.1 不会变成其它状态  
  2. 2.1.3.2 必须有一个promise被reject的reason 

概括即是:promise的状态只能从pending变成fulfilled,或者从pending变成rejected.promise成功,有成功的value.promise失败的话,有失败的原因

2.2 then方法

promise必须提供一个then方法,来访问最终的结果

promise的then方法接收两个参数

 
 
 
  1. promise.then(onFulfilled, onRejected) 

2.2.1 onFulfilled 和 onRejected 都是可选参数

 
 
 
  1. 2.2.1.1 onFulfilled 必须是函数类型  
  2. 2.2.1.2 onRejected 必须是函数类型 

2.2.2 如果 onFulfilled 是函数:

 
 
 
  1. 2.2.2.1 必须在promise变成 fulfilled 时,调用 onFulfilled,参数是promise的value  
  2. 2.2.2.2 在promise的状态不是 fulfilled 之前,不能调用  
  3. 2.2.2.3 onFulfilled 只能被调用一次 

2.2.3 如果 onRejected 是函数:

 
 
 
  1. 2.2.3.1 必须在promise变成 rejected 时,调用 onRejected,参数是promise的reason  
  2. 2.2.3.2 在promise的状态不是 rejected 之前,不能调用  
  3. 2.2.3.3 onRejected 只能被调用一次 

2.2.4 onFulfilled 和 onRejected 应该是微任务

2.2.5 onFulfilled  和 onRejected 必须作为函数被调用

2.2.6 then方法可能被多次调用

 
 
 
  1. 2.2.6.1 如果promise变成了 fulfilled态,所有的onFulfilled回调都需要按照then的顺序执行  
  2. 2.2.6.2 如果promise变成了 rejected态,所有的onRejected回调都需要按照then的顺序执行 

2.2.7 then必须返回一个promise

 
 
 
  1. promise2 = promise1.then(onFulfilled, onRejected);  
  2. 2.2.7.1 onFulfilled 或 onRejected 执行的结果为x,调用 resolvePromise  
  3. 2.2.7.2 如果 onFulfilled 或者 onRejected 执行时抛出异常e,promise2需要被reject  
  4. 2.2.7.3 如果 onFulfilled 不是一个函数,promise2 以promise1的值fulfilled  
  5. 2.2.7.4 如果 onRejected 不是一个函数,promise2 以promise1的reason rejected 

2.3 resolvePromise

resolvePromise(promise2, x, resolve, reject)

2.3.1 如果 promise2 和 x 相等,那么 reject promise with a TypeError

2.3.2 如果 x 是一个 promsie

 
 
 
  1. 2.3.2.1 如果x是pending态,那么promise必须要在pending,直到 x 变成 fulfilled or rejected.  
  2. 2.3.2.2 如果 x 被 fulfilled, fulfill promise with the same value.  
  3. 2.3.2.3 如果 x 被 rejected, reject promise with the same reason. 

2.3.3 如果 x 是一个 object 或者 是一个 function

 
 
 
  1. 2.3.3.1 let then = x.then.  
  2. 2.3.3.2 如果 x.then 这步出错,那么 reject promise with e as the reason..  
  3. 2.3.3.3 如果 then 是一个函数,then.call(x, resolvePromiseFn, rejectPromise)  
  4.     2.3.3.3.1 resolvePromiseFn 的 入参是 y, 执行 resolvePromise(promise2, y, resolve, reject);  
  5.     2.3.3.3.2 rejectPromise 的 入参是 r, reject promise with r.  
  6.     2.3.3.3.3 如果 resolvePromise 和 rejectPromise 都调用了,那么第一个调用优先,后面的调用忽略。  
  7.     2.3.3.3.4 如果调用then抛出异常e   
  8.         2.3.3.3.4.1 如果 resolvePromise 或 rejectPromise 已经被调用,那么忽略  
  9.         2.3.3.3.4.3 否则,reject promise with e as the reason  
  10. 2.3.3.4 如果 then 不是一个function. fulfill promise with x. 

2.3.4 如果 x 不是一个 object 或者 function,fulfill promise with x.

Promise的其他方法

虽然上述的promise源码已经符合PromiseA+的规范,但是原生的Promise还提供了一些其他方法,如:

  1.  Promise.resolve()
  2.  Promise.reject()
  3.  Promise.prototype.catch()
  4.  Promise.prototype.finally()
  5.  Promise.all()
  6.  Promise.race()

下面具体说一下每个方法的实现:

Promise.resolve

Promise.resolve(value) 返回一个以给定值解析后的Promise 对象.

  1.  如果 value 是个 thenable 对象,返回的promise会“跟随”这个thenable的对象,采用它的最终状态
  2.  如果传入的value本身就是promise对象,那么Promise.resolve将不做任何修改、原封不动地返回这个promise对象。
  3.  其他情况,直接返回以该值为成功状态的promise对象。 
 
 
 
  1. Promise.resolve = function (param) {  
  2.         if (param instanceof Promise) {  
  3.         return param;  
  4.     }  
  5.     return new Promise((resolve, reject) => {  
  6.         if (param && typeof param === 'object' && typeof param.then === 'function') {  
  7.             setTimeout(() => {  
  8.                 param.then(resolve, reject);  
  9.             });  
  10.         } else {  
  11.             resolve(param);  
  12.         }  
  13.     });  

thenable对象的执行加 setTimeout的原因是根据原生Promise对象执行的结果推断的,如下的测试代码,原生的执行结果为: 20  400  30;为了同样的执行顺序,增加了setTimeout延时。

测试代码:

 
 
 
  1. let p = Promise.resolve(20);  
  2. p.then((data) => {  
  3.     console.log(data);  
  4. });  
  5. let p2 = Promise.resolve({  
  6.     then: function(resolve, reject) {  
  7.         resolve(30);  
  8.     }  
  9. });  
  10. p2.then((data)=> {  
  11.     console.log(data)  
  12. });  
  13. let p3 = Promise.resolve(new Promise((resolve, reject) => {  
  14.     resolve(400)  
  15. }));  
  16. p3.then((data) => {  
  17.     console.log(data)  
  18. }); 

Promise.reject

Promise.reject方法和Promise.resolve不同,Promise.reject()方法的参数,会原封不动地作为reject的理由,变成后续方法的参数。

 
 
 
  1. Promise.reject = function (reason) {  
  2.     return new Promise((resolve, reject) => {  
  3.         reject(reason);  
  4.     });  

Promise.prototype.catch

Promise.prototype.catch 用于指定出错时的回调,是特殊的then方法,catch之后,可以继续 .then

 
 
 
  1. Promise.prototype.catch = function (onRejected) {  
  2.     return this.then(null, onRejected);  

Promise.prototype.finally

不管成功还是失败,都会走到finally中,并且finally之后,还可以继续then。并且会将值原封不动的传递给后面的then.

 
 
 
  1. Promise.prototype.finally = function (callback) {  
  2.     return this.then((value) => {  
  3.         return Promise.resolve(callback()).then(() => {  
  4.             return value;  
  5.         });  
  6.     }, (err) => {  
  7.         return Promise.resolve(callback()).then(() => {  
  8.             throw err;  
  9.         });  
  10.     });  

Promise.all

Promise.all(promises) 返回一个promise对象

  1.  如果传入的参数是一个空的可迭代对象,那么此promise对象回调完成(resolve),只有此情况,是同步执行的,其它都是异步返回的。
  2.  如果传入的参数不包含任何 promise,则返回一个异步完成.
  3.  promises 中所有的promise都promise都“完成”时或参数中不包含 promise 时回调完成。
  4.  如果参数中有一个promise失败,那么Promise.all返回的promise对象失败
  5.  在任何情况下,Promise.all 返回的 promise 的完成状态的结果都是一个数组 
 
 
 
  1. Promise.all = function (promises) {  
  2.     promises = Array.from(promises);//将可迭代对象转换为数组  
  3.     return new Promise((resolve, reject) => {  
  4.         let index = 0;  
  5.         let result = [];  
  6.         if (promises.length === 0) {  
  7.             resolve(result);  
  8.         } else {  
  9.             function processValue(i, data) { 
  10.                  result[i] = data;  
  11.                 if (++index === promises.length) {  
  12.                     resolve(result);  
  13.                 }  
  14.             }  
  15.             for (let i = 0; i < promises.length; i++) {  
  16.                   //promises[i] 可能是普通值  
  17.                   Promise.resolve(promises[i]).then((data) => {  
  18.                     processValue(i, data);  
  19.                 }, (err) => {  
  20.                     reject(err); 
  21.                      return;  
  22.                 });  
  23.             }  
  24.         }  
  25.     });  

测试代码:

 
 
 
  1. var promise1 = new Promise((resolve, reject) => {  
  2.     resolve(3);  
  3. })  
  4. var promise2 = 42;  
  5. var promise3 = new Promise(function(resolve, reject) {  
  6.   setTimeout(resolve, 100, 'foo');  
  7. });  
  8. Promise.all([promise1, promise2, promise3]).then(function(values) {  
  9.   console.log(values); //[3, 42, 'foo']  
  10. },(err)=>{  
  11.     console.log(err)  
  12. });  
  13. var p = Promise.all([]); // will be immediately resolved  
  14. var p2 = Promise.all([1337, "hi"]); // non-promise values will be ignored, but the evaluation will be done asynchronously  
  15. console.log(p);  
  16. console.log(p2)  
  17. setTimeout(function(){  
  18.     console.log('the stack is now empty');  
  19.     console.log(p2);  
  20. }); 

Promise.race

Promise.race函数返回一个 Promise,它将与第一个传递的 promise 相同的完成方式被完成。它可以是完成( resolves),也可以是失败(rejects),这要取决于第一个完成的方式是两个中的哪个。

如果传的参数数组是空,则返回的 promise 将永远等待。

如果迭代包含一个或多个非承诺值和/或已解决/拒绝的承诺,则 Promise.race 将解析为迭代中找到的第一个值。

 
 
 
  1. Promise.race = function (promises) {  
  2.     promises = Array.from(promises);//将可迭代对象转换为数组  
  3.     return new Promise((resolve, reject) => {  
  4.         if (promises.length === 0) {  
  5.             return; 
  6.          } else {  
  7.             for (let i = 0; i < promises.length; i++) {  
  8.                 Promise.resolve(promises[i]).then((data) => {  
  9.                     resolve(data);  
  10.                     return;  
  11.                 }, (err) => {  
  12.                     reject(err);  
  13.                     return;  
  14.                 });  
  15.             }  
  16.         }  
  17.     });  

测试代码:

 
 
 
  1. Promise.race([  
  2.     new Promise((resolve, reject) => { setTimeout(() => { resolve(100) }, 1000) }),  
  3.     undefined,  
  4.     new Promise((resolve, reject) => { setTimeout(() => { reject(100) }, 100) })  
  5. ]).then((data) => {  
  6.     console.log('success ', data);  
  7. }, (err) => {  
  8.     console.log('err ',err);  
  9. });  
  10. Promise.race([  
  11.     new Promise((resolve, reject) => { setTimeout(() => { resolve(100) }, 1000) }),  
  12.     new Promise((resolve, reject) => { setTimeout(() => { resolve(200) }, 200) }),  
  13.     new Promise((resolve, reject) => { setTimeout(() => { reject(100) }, 100) })  
  14. ]).then((data) => {  
  15.     console.log(data);  
  16. }, (err) => {  
  17.     console.log(err);  
  18. });  

本文名称:带你写出符合Promise/A+ 规范Promise的源码
网站网址:http://www.hantingmc.com/qtweb/news40/343140.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联