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

推荐阅读更多精彩内容