一. Promise是什么？
Promise是一种异步操作的解决方案，将写法复杂的传统的回调函数和监听事件的异步操作，用同步代码的形式表达出来。
避免了多级异步操作的回调函数嵌套。
Promise最早是一个函数库，现在已经被ES6写入标准用法。
Promise是一种构造函数。
Promise实例创建后会立即执行。
new Promise((resolve,reject)=> { // resolve,reject是形式参数，可以是任意写法，如(res, rej),默认第一个参数实现的是resolve功能；第二个参数实现的是reject功能。
console.log("1");
resolve("success")
});
console.log("2");
// 执行结果
1
2
创建实例如下:
//构造函数传参格式固定，就是函数加（resolve,reject）的参数，这是规定！！
const myPromise = new Promise(function(resolve, reject){
//自己需要实现的异步操作的内容
......
......
if(成功) resolve(value);
// resolve是js引擎提供定的成功后调用的函数，作用就是手动将该promise的状态由
// pending(未完成)变为fulfilled(异步操作成功)，然后立即触发then中的成功回调函数
// value值是异步操作的结果，要传给后面的回调函数的值
// 值的内容可以根据业务需求自己定；可以是值(普通对象，函数，字符，数字等)也可以是Promise对象
else reject(new Error);
// reject也是js引擎提供的失败后调用的函数，作用就是手动将状态由pending变为
// rejected(异步操作失败)，参数是抛出的异常。然后才能触发then中的错误回调函数或者catch中的回调函数
})
Promise的参数函数
new Promise(function(resolve, reject){
//....
})
参数函数的resolve方法除了可以返回数据处理结果，还可以返回一个promise实例，
当返回promise实例的时候（resolve(promiseObj)），当前实例的状态无效，状态以参数实例(promiseObj)的状态为准。
返回的结果也以参数实例的返回结果为准。
示例：
// 将实例p1作为p2的resolve返回参数
const p1 = new Promise(function(resolve, reject){
setTimeout(() => resolve("success"), 2000);
});
const p2 = new Promise(function(resolve, reject){
setTimeout(() => resolve(p1), 1000); // p2的状态由p1决定
});
p2.then(function(data) {
console.log(data); // success 2秒后打印p1的返回结果；说明then方法在状态改变后被触发。
}, function() {
}).catch(err => console.log(err))
resolve(）不同于return, resolve()执行完成后后面的代码还会执行。
new Promise((resolve,reject)=> {
resolve("success");
console.log("1"); //会打印
});
// 一般状态改变后的操作放在then回调函数中
// 所以最好写成
new Promise((resolve,reject)=> {
return resolve("success");
console.log("1"); //不再执行，最好不要在状态改变后添加操作
});
二、Promise的实例方法
1. Promise.prototype.then()
then方法是Promise构造函数原型对象上的方法。
作用： 为实例状态改变时添加回调函数（相当于实例状态变化的监听函数）。
1）then方法接受两个回调函数作为参数，第一个函数是实例状态变为resolved(fulfilled)时的回调函数；
第二个函数是实例状态变为rejected时的回调函数。
myPromise.then(function(value){
// 前面实例中resolve方法执行后触发该方法，即状态为fulfilled(resolved)状态时触发的回调函数
// value值就是resolve的参数值
},function(err) {
// 前面实例中reject方法执行后会触发该方法，即状态为rejected时
})
2）then方法返回一个新的Promise实例，所以可以采用链式写法;
then方法的第一个回调函数的返回值，即return的值作为下一个then方法里面的函数传参。
如果返回值是非Promise对象，会触发下一个then方法的第一个回调函数, 并且返回值作为回调函数的参数；
const p1 = new Promise(function(resolve, reject) {
resolve("success")
})
function fn() { return 5 } // 不论返回值是什么，返回结果结果都是下个then方法的第一个函数的参数，即使return new Error()
p1.then(fn).then(
result => console.log("1-->",result), //1-->5 如果fn返回new Error('fail'),则1-->Error: fail
err => console.log('err-->',err) // 不执行
)
如果前一个then方法返回值是promise对象，则程序会等待该promise对象的状态发生变化（resolved或rejected）时触发下一个then方法。
const p1 = new Promise(function(resolve, reject) {
resolve("success")
})
const p2 = new Promise(function(resolve, reject) {
reject(new Error("p2"))
})
function fn() {
return p2; // 返回Promise对象；
}
p1.then(fn).then(
result => console.log('1-->',result), // 不执行
err => console.log('err-->',err) // err-->Error: p2
)
3）then方法rejected状态具有传递性，即如果实例调用reject(),则在所有的then方法的第二个函数中都能取到reject返回的值。
如果确实发生错误，则会执行最近的then方法的第二个回调函数，之后的错误回调函数都不再执行
new Promise(fn)
.then(f1) // 省略了rejected状态的回调函数,但是实际运行的时候还是会默认调用该then方法
.then(f2)
.then(f3)
.then(f4, r1) // 这种写法不好，最好在最后使用catch方法
.then(f4, r2)
// 如果promise实例状态为rejected, 那么f1,f2,f3,f4都不会执行，但是r1执行，因为报错具有传递性。但是fulfilled状态的话，只能触发最近的成功回调
// r2不执行，错误相当于被r2捕获
4) 如确认then方法中回调函数的返回值问题
const p1 = new Promise(function(resolve, reject) {
resolve("success")
})
function fn() {
return 5;
}
p1.then(fn()).then(result => console.log('1',result));// "success" .then(fn)相当于then(5)，忽略该then方法
p1.then(fn).then(result => console.log('2',result)); //
p1.then(function(){fn()}).then(result => console.log('3',result)); // undefined
p1.then(function(){return fn()}).then(result => console.log('4',result)); //
5) then方法中的回调函数是异步任务，是微任务；诸如setTimeout是宏任务；
微任务加入本轮事件循环最下面；宏任务加入下一轮事件循环。因为主栈的任务也属于宏任务。
setTimeout(() => console.log('1'),0);
new Promise((resolve,reject)=> resolve(1)).then(() => console.log('2'))
console.log('3');
// 执行结果如下：
3
2
1
2. Promise.prototype.catch()
Promise原型上的catch方法,相当于.then(null/undefined, () => {})，所以返回的也是promise，后面还可以跟then或者catch,只在rejected状态触发。
1. 它可以捕获所有之前执行的promise中的错误
最好所有的promise都在最后使用catch方法，不要在then方法中写第二个回调函数
myPromise.then((val) => {
throw new Error("failed");
}).then((val) => {
// TODO
}).catch((err) => {
console.log(err); // Error: failed 捕获内部异常
})
2. 在promise实例中，throw异常发生在resolve()之后, 抛出异常被忽略。
因为resolve之后，状态改变后永久保留该状态，不能再次改变。throw本质上是将状态修改为rejected。
new Promise((resolve,reject)=> {
resolve('ok');
throw new Error('ok');
}).then((data) => console.log('data-->',data)) // data-->ok
.catch(err => console.log('err-->',err)); // 不执行;抛出异常被忽略
// 执行结果如下：
data-->ok
// throw new Error('ok') 相当于
new Promise((resolve,reject)=> {
resolve('ok'); // 状态已经改变；后面本质也是修改状态；Promise状态改变后不再变化。
try {
throw new Error('ok');
}catch (err) { //也说明了promise内部异常不会影响外部
reject(err);
}
}).then((data) => console.log('data-->',data)) // data-->ok
.catch(err => console.log('err-->',err)); // 不执行;抛出异常被忽略
如果抛出异常的位置在resolve方法后且在一个异步任务中，如setTimeout中，则在"下一轮"事件循环触发，此时promise已经执行完成。
因为then方法是微任务，比setTimeout先执行。在promise外抛出异常。
const promise = new Promise(function (resolve, reject) {
resolve('ok');
setTimeout(function () { throw new Error('外部错误') }, 0);
});
promise.then(
(data) => console.log('data-->',data)
).catch(err => console.log('err-->',err);
// 运行结果如下：
data-->ok
Uncaught Error: 外部错误
3. Promise内部抛出异常后，即使不捕获也不会导致代码的终止运行。
即Promise内部的异常只在Promise内部。
new Promise((resolve,reject)=> {
throw new Error("err")
// 相当于
try {
throw new Error("err")
} catch(err) {
reject(err)
}
}); // 错误不会终止代码
console.log("会执行");
// 执行结果如下；错误信息会打印
"会执行"
Uncaught (in promise) Error: err
4. catch方法返回一个promise, 且将状态由rejected变为resolved。catch方法的返回值将作为后续回调函数的参数。
所以后面可以接着调用then方法。
const promise = new Promise(function (resolve, reject) {
throw new Error("错误")
});
promise
.then(data => console.log('data-->',data))
.catch(err => {
console.log('Caught err-->',err);
return err; // 相当于resolve(err)
}).then((a) => console.log('go on-->',a));
// 运行结果如下：
Caught err-->Error: 错误
go on-->Error: 错误
3. Promise.prototype.finally()
不管状态(不能是pending)如何，都会执行的方法。语法：
new Promise((resolve,reject) => {
// 状态修改为resolved或者rejected
}).finally(() => {...} )
finally方法最后返回一个promise实例，回调函数不接受任何值，return方法也被忽略。
但是会默认返回之前的实例对象传递的参数。
本质上，finally也是then的特例。
Promise.prototype.finally = function(callback) {
const P = this.constructor;
return this.then(
(value) => P.resolve(callback()).then(() => value),
(reason) => P.resolve(callback()).then(() =>{ throw reason})
)
}
示例：
const p = new Promise((resolve,reject) => {
resolve(2)
}).finally((data) => {
console.log(data); //undefined 不接受任何参数
return 5;
}).then(after => {
console.log(after); // 2，之前的参数
});
应用：
如处理文件完成后，不论成功与否都关闭文件。
三. 静态方法
1.Promise.resolve()
该方法将对象或者非对象转为resolved(fulfilled)状态的promise对象。语法如下：
Promise.resolve(data);
// 相当于；
new Promise(function(resolve, reject){
resolve(data);
})
1. 没有参数时
直接返回一个resolve状态的promise对象。then方法会立即执行。
Promise.resolve().then(
result => console.log(result); // undefined
)
2. 参数是一个promise对象，不做任何处理
返回参数对象自身；此时和new Promise的写法运行结果不同。
const p = Promise.resolve();
const p1 = Promise.resolve(p); //就是p
const p2 = new Promise(res => res(p)); //新建一个对象，对象状态依赖p
// res(p)可以看作 await p; await fulfilled; // 首先；p1 === p; p2!===p
console.log(p === p1); // true
console.log(p === p2); // false
/******第一种情况***********/
p1.then(() => {
console.log('p1-1');
}).then(() => {
console.log('p1-2');
})
p.then(() => {
console.log('p-1');
}).then(() => {
console.log('p-2');
})
// 运行结果如下：
p1-1
p-1
p1-2
p-2
/*******第二种情况********/
p2.then(() => {
console.log('p2-1');
}).then(() => {
console.log('p2-2');
}).then(() => {
console.log('p2-3');
})
p.then(() => {
console.log('p-1');
}).then(() => {
console.log('p-2');
}).then(() => {
console.log('p-3');
})
// 运行结果如下
p-1
p-2
p2-1
p-3
p2-2
p2-3
3. 参数是一个普通的对象(不含then方法) / 原始值 / 单独的then方法
返回一个promise对象，且resolve的参数是被处理的参数
Promise.resolve('hello world').then(result => console.log(result));
Promise.resolve({a: 'hello'}).then(result => console.log(result));
function then(resolve, reject) {
consoel.log('test'); // 不会执行
resolve('fn');
}
Promise.resolve(then).then(result => console.log('fn--',result))
// 运行结果如下：
hello world
{a: 'hello'}
fn--function then(resolve,reject){resolve('fn')}
4.参数是一个带有普通then方法的对象
返回一个状态是pending的promise对象。不会触发后面的then方法的回调函数。
const obj = {
then() { console.log('then') }
}
Promise.resolve(obj).then(result => console.log('obj1-->',result));
// 相当于
new Promise((resolve,reject) => {
// obj含有then方法
resolve(obj); // 相当于obj.then()立即执行，后面没有处理状态的函数
})
运行结果：只打印then
5. 参数对象的then方法是一个带有函数参数的方法
因为对象的then方法默认立即执行，系统默认将resolve,reject作为参数传入对象的then方法。
即第一个参数是resolve,第二个参数是reject。
- 如果对象的then方法,没有调用函数参数，相当于普通then方法，返回一个pending状态的promise对象
- 如果调用了then方法中的函数参数，返回一个promise对象，函数参数的数据是promise对象返回的数据
const thenable = {
then(a,b) {
console.log('console-thenable');
a('ok');
}
}
Promise.resolve(thenable)
.then(result => console.log('thenable1-->',result))
.catch(err => console.log('err1-->', err))
// 相当于
new Promise((resolve,reject) => {
resolve(thenable); //相当于thenbale.then(resolve,reject)--> resolve('ok')
}).then(result => console.log('thenable2-->', result))
.catch(err => console.log('err-->',err));
// 运行结果如下：
console-thenable //立即执行的结果
console-thenable
thenable1-->ok
thenable2-->ok
//如果修改obj的内容如下；
const thenable = {
then(a,b) {
console.log('console-thenable');
b(new Error('err'));
}
}
// 运行结果如下：
console-thenable
console-thenable
err1-->Error: err
err2-->Error: err
应用：
将函数转为异步操作
function getData() {
return 5;
}
// 要求在返回数据后进行后续操作
Promise.resolve(getData()).then(data => {
console.log(data); //
})
2. Promise.reject()
返回一个promise实例，实例状态为rejected。语法：
Promise.reject(obj);
// 相当于
new Promise(function(resolve,reject) {
reject(obj)
})
即使遇到含有then方法的对象是处理结果和Promise.resolve()不同。
// .catch
const obj = {
thenable: (res,rej) => {
rej('err');
}
}
Promise.reject(obj).catch(err => {
console.log(err); //err不是rej的参数,而是整个obj对象{thenable: f}
});
3. Promise.all()
接受一个数组（每个参数都是promise实例）或者 Iterator接口（每个返回值都是promise实例）作为参数。
如果参数不是promise实例，系统会自动调用Promise.resolve()方法，将参数转为promise实例。
const arr = [1,2];
Promise.all(arr) // 相当于 arr.map(i => Promise.resolve(i))
.then(data => console.log('data-->',data))
/****运行结果如下***/
// data--> [1,2]
返回一个新的Promise实例。
const promises = [1,3,4,5].map(item => Promise.resolve(item));
const newP = Promise.all(promises); //生成新的实例
状态由参数中的每个实例共同决定。
1）如果新的实例状态为fulfilled, 则要求所有的参数实例的状态都是fulfilled。
此时，每个实例的返回值组成一个数组传递给回调函数。
const promises = [1,3,4,5]; // 自动转promise
const newP = Promise.all(promises); //生成新的实例
// promises对应实例对象全部都是fulfilled状态
newP.then(result => console.log('result-->', result));
// 也可以使用参数解构
newP.then(([p1,p2,p3,p4]) => console.log(p1,p2,p3,p4));
//运行结果如下：
result-->[1,3,4,5]
1 3 4 5
2) 如果新的实例状态为rejected,只要参数实例有一个被rejected,就会触发新实例的回调函数。
且被rejected实例的返回值会作为回调函数的参数。
const promises1 = [1,3,4,5].map(item => Promise.resolve(item));
const promises2 = new Promise((resolve, reject) => {
setTimeout(() => {
reject(new Error('错误'))
}, 5000); // 该setTimeout虽然是异步任务，但是promise还未执行完，所以还是promise内部的异常。区分
})
const newP = Promise.all([...promises1, promises2]); //生成新的实例
newP.then(result => console.log('result-->', result))
.catch(err => console.log('err-->', err)); // 运行结果如下：
err-->Error: 错误 // 5秒中后打印
3）如果参数中的实例自己有catch方法，那么不会触发新实例的catch方法
// 当参数实例没有catch方法，捕获第一个错误
const p1 = Promise.reject('err1');
const p2 = Promise.reject('err2');
Promise.all([p1,p2])
.then(data => console.log('data-->',data))
.catch(err => console.log('err-->',err)); // err1 catch方法返回的Promise对象是resolved状态
/***运行结果如下***/
err-->err1 // 当参数实例自己有catch方法
const p1 = Promise.reject(new Error('err1')).catch(err => err);
const p2 = Promise.reject(new Error('err2')).catch(err => 5);
Promise.all([p1,p2])
.then(data => console.log('data-->',data))
.catch(err => console.log('err-->',err));
/****运行结果如下***/
data--> [Error: err1, 5]
4. Promise.race()
参数性质和Promise.all()一样，都是以参数为Promise实例的数组为参数。如果不是实例，自动转为实例。
返回一个新的Promise实例。
作用不一样：
只要有一个参数实例的状态发生改变，新的实例的状态随之改变，参数实例的返回值作为对应的回调函数的参数。
应用：用来设置超时时间
function fetch(url) {
return new Promise((resolve,reject) => {
setTimeout(() => {
// 伪代码，2秒钟才能拿到结果
resolve('data')
}, 2000)
})
}
const p1 = fetch();
const p2 = new Promise((resolve,reject) => {
setTimeout(() => {
reject(new Error("请求超时"));
}, 500); // 相当于设置超时时间为500ms
});
Promise.race([p1,p2])
.then(data => console.log('data-->',data))
.catch(err => console.log('err-->',err))
// 运行结果如下
err--> Error: 请求超时 //500ms后打印
5. Promise.allSelected() ES2020：浏览器支持
参数同上，返回一个新的Promise对象。
该方法等待所有的参数实例对象状态全部改变（返回结果），才会触发回调。
且新的对象的状态只有fulfilled一个状态。
回调函数的参数是一组对象组成的数组：
// 主要有两种
[
{status: 'fulfilled', value: 'data'}, // 成功
{status: 'rejected', reason: Error: 请求超时} // 失败
....
]
示例：
function fetch(url) {
return new Promise((resolve,reject) => {
setTimeout(() => {
// 伪代码，2秒钟才能拿到结果
resolve('data')
}, 2000)
})
}
const p1 = fetch();
const p2 = new Promise((resolve,reject) => {
setTimeout(() => {
reject(new Error("请求超时"));
}, 500); // 相当于设置超时时间为500ms
});
Promise.allSettled([p1,p2])
.then(data => console.log('data-->',data))
.catch(err => console.log('err-->',err))
// 运行结果如下：
data -->[{status: 'fulfilled', value: 'data'}, {status: 'rejected', reason: Error: 请求超时}] //2秒后打印
应用：
不关心运行结果，只关心是否运行结束时
Promise.allSettled([p1,p2,p3]).then(result => {
//只要触发回调函数，就证明所有的参数实例全部运行完成
})
6. Promise.any() 提案
参数同上。返回一个新的Promise对象。
只要有一个状态变为fulfilled，新的对象状态变为fulfilled,触发回调；
所有的状态变为rejected，新的对象的状态才变为rejected，触发catch回调。
回调函数的参数是一个所有实例返回错误结果的数组。
7. Promise.try(）提案
参数是一个函数。用于统一同步函数和异步函数的处理机制。
fn是同步函数，就按照同步函数的规则运行；如果fn是异步函数，就按照异步函数运行。
Promise.try(fn)
.then()
.catch()