Promise对象方法

Promise.prototype.then()

Promise实例具有then方法，也就是说，then方法是定义在原型对象Promise.prototype上的，它的作用是为Promise实例添加状态改变的回调函数，then方法的第一个参数是resolved状态函数，第二个参数为可选值，是rejected状态的回调函数

then方法返回的是一个新的Promise实例，因此可以采用链式写法，即then方法后面再调用另一个then方法

    //使用then方法指定两个回调函数
    //第一个回调函数完成后，将返回结果作为参数传入第二个回调函数
    getJson('./posts.json').then(function(json){
        return json.post;
    }).then(function(post){
        //...
    })

采用链式的then，可以指定一组按照次序调用的回调函数，这时，前一个回调函数，有可能返回的还是一个Promise对象（即有异步操作），这时，后一个回调函数，就会等待该Promise对象的状态发生变化，才会被调用

    //第一个then方法指定的回调函数，返回的是另一个Promise对象
    //这时，第二个方法指定的回调函数，就会等待这个新的Promise对象状态发生变化
    getJson('./post.json').then(function(post){
        return getJson(post.commentURL);
    }).then(function funA(comments){
    //如果状态变化为resolved，就调用funA
        console.log('resolved:',comments)
    },function funB(err){
    //如果状态变化为rejected，就调用funB
        console.log('rejected:',err)
    })

采用箭头函数的话，上面代码可以写的更简洁

    getJson('./post.json').then(
        post => getJson(post.commentURL)
    ).then(
        comments => console.log('resolved:',comments),
        err => console.log('rejected:',err)
    )

Promise.prototype.catch()

Promise.prototype.catch方法是.then(null,rejected)或.then(undefined,rejected)的别名，用于发生错误时的回调函数

    getJson('./post.json').then(function(posts) {
        //...
    }).catch(function(error) {
        //处理getJson和前一个回调函数运行时发生的错误
        console.log('错误：', error)
    })

上面代码中，getJson方法返回一个Promise对象，如果该对象状态变为resolved，则会调用then方法指定回调函数；如果异步操作发生错误，状态就回变为rejected，就会调用catch方法指定的回调函数，处理这个错误，另外，then方法指定的回调函数，如果运行中抛出错误，也会被catch方法捕获

• 举个🌰

    const promise = new Promise(function(resolve, reject) {
        throw new Error('test')
    })
    //promise抛出一个错误，就被catch方法指定的回调函数捕获
    promise.catch(function(error) {
        console.log(error)
    })
    //Error: test
  

下面的两种写法与上面代码等同

    // 写法一
    const promise = new Promise(function(resolve, reject) {
        try {
        throw new Error('test');
        } catch(e) {
        reject(e);
        }
    });
    promise.catch(function(error) {
        console.log(error);
    });
    
    // 写法二
    const promise = new Promise(function(resolve, reject) {
        reject(new Error('test'));
    });
    promise.catch(function(error) {
        console.log(error);
    });

比较上面两种写法，可以得出reject方法的作用，等同于抛出错误

• 如果Promise状态已经变成resolved，再抛出错误是无效的

    const promise = new Promise(function(resolve, reject) {
        resolve('ok');
        throw new Error('test');
    })
  
    promise.then(function(value) {
        console.log(value)
    }).catch(function(error) {
        console.log(error)
    })
    //ok
  

Promise在resolved语句后面，再抛出错误，不会被捕获，等同于没有抛出，因为Promise的状态一旦改变，就永久保持该状态，不会再变了

Promise对象的错误具有冒泡性质，会一直向后传递，直到被捕获为止，也就是说，错误总是会被下一个catch语句捕获

    getJSON('./1.json').then(function (post) {
        return getJSON(post.commentURL);
    }).then(function (comments) {
        // some code
    }).catch(function (error) {
        // 处理前面三个Promise产生的错误
    });

一般建议是Promise后面跟着catch方法，这样可以处理Promise内部发生的错误，catch方法返回的还是一个Promise对象，因此后面还可以接着调用then方法

    const someAsyncThing = () => {
        return new Promise((resolved, reject) => {
            //下一行为报错语句
            resolved(x++)
        })
    }
    someAsyncThing().catch((error) => {
        console.log('error:', error)
    }).then(() => {
        console.log('then')
    })
    /*上面代码运行完catch方法指定的回调函数，会接着运行后面那个then方法指定的回调函数，如未报错，则跳过catch方法*/
    //error: ReferenceError: x is not defined
    //then

Promise.prototype.finally()

finally方法用于指定不管 Promise 对象最后状态如何，都会执行的操作。该方法是 ES2018 引入标准的。

  promise
   .then(result => {···})
   .catch(error => {···})
   .finally(() => {···});

下面是一个例子，服务器使用 Promise 处理请求，然后使用finally方法关掉服务器。

      server.listen(port)
        .then(function () {
          // ...
        })
        .finally(server.stop);

finally方法的回调函数不接受任何参数，这意味着没有办法知道，前面的 Promise 状态到底是fulfilled还是rejected。这表明，finally方法里面的操作，应该是与状态无关的，不依赖于 Promise 的执行结果。

Promise.all()

Promise.all方法用于将多个 Promise 实例，包装成一个新的 Promise 实例。

  const p = Promise.all([p1, p2, p3]);

上面代码中，Promise.all方法接受一个数组作为参数，p1、p2、p3都是 Promise 实例，如果不是，就会先调用下面讲到的Promise.resolve方法，将参数转为 Promise 实例，再进一步处理。（Promise.all方法的参数可以不是数组，但必须具有 Iterator 接口，且返回的每个成员都是 Promise 实例。）

p的状态由p1、p2、p3决定，分成两种情况。

（1）只有p1、p2、p3的状态都变成fulfilled，p的状态才会变成fulfilled，此时p1、p2、p3的返回值组成一个数组，传递给p的回调函数。

（2）只要p1、p2、p3之中有一个被rejected，p的状态就变成rejected，此时第一个被reject的实例的返回值，会传递给p的回调函数。

Promise.race()

Promise.race方法同样是将多个 Promise 实例，包装成一个新的 Promise 实例。

  const p = Promise.race([p1, p2, p3]);

上面代码中，只要p1、p2、p3之中有一个实例率先改变状态，p的状态就跟着改变。那个率先改变的 Promise 实例的返回值，就传递给p的回调函数。

Promise.race方法的参数与Promise.all方法一样，如果不是 Promise 实例，就会先调用下面讲到的Promise.resolve方法，将参数转为 Promise 实例，再进一步处理。

Promise.resolve()

有时需要将现有对象转为 Promise 对象，Promise.resolve方法就起到这个作用。

    Promise.resolve('foo')
    // 等价于
    new Promise(resolve => resolve('foo'))

Promise.reject()

Promise.reject(reason)方法也会返回一个新的 Promise 实例，该实例的状态为rejected。

    const p = Promise.reject('出错了');
    // 等同于
    const p = new Promise((resolve, reject) => reject('出错了'))

    p.then(null, function (s) {
      console.log(s)
    });
    // 出错了

Promise.try()

实际开发中，经常遇到一种情况：不知道或者不想区分，函数f是同步函数还是异步操作，但是想用 Promise 来处理它。因为这样就可以不管f是否包含异步操作，都用then方法指定下一步流程，用catch方法处理f抛出的错误。一般就会采用下面的写法。

    Promise.resolve().then(f)

上面的写法有一个缺点，就是如果f是同步函数，那么它会在本轮事件循环的末尾执行。

    const f = () => console.log('now');
    Promise.resolve().then(f);
    console.log('next');
    // next
    // now

• 那么有没有一种方法，让同步函数同步执行，异步函数异步执行，并且让它们具有统一的 API 呢？回答是可以的，并且还有两种写法。第一种写法是用async函数来写。

    const f = () => console.log('now');
    (async () => f())();
    console.log('next');
    // now
    // next

第二种写法是使用new Promise()。

    const f = () => console.log('now');
    (
      () => new Promise(
        resolve => resolve(f())
      )
    )();
    console.log('next');
    // now
    // next