Promises/A+ API 属性源码剖析

前端

2023-12-24 04:00:59

前言

Promises 是 JavaScript 语言中一种用于处理异步操作的机制。它提供了一种更简洁、更优雅的方式来管理异步操作，避免了使用回调函数带来的繁琐和混乱。

Promises/A+ 是 JavaScript 语言中定义的规范，用于规范 Promise 对象的实现。它规定了 Promise 对象必须具备的基本属性和方法，以及这些属性和方法必须遵循的行为。

本文将对 Promises/A+ API 属性的源码进行详细分析，并附带了注解，以帮助读者更好地理解 Promises/A+ 规范的具体内容。

Promises/A+ API 属性源码分析

Promises/A+ API 属性主要包括以下几个方面：

Promise 对象的状态
Promise 对象的结果
Promise 对象的 then 方法
Promise 对象的 catch 方法
Promise 对象的 finally 方法

Promise 对象的状态

Promise 对象的状态可以是以下三种之一：

pending：表示 Promise 对象尚未完成。
fulfilled：表示 Promise 对象已成功完成。
rejected：表示 Promise 对象已失败完成。

Promise 对象的状态可以通过 state 属性获取。

class Promise {
  constructor(executor) {
    this.state = 'pending';
    this.result = undefined;

    executor(resolve, reject);
  }

  // ...
}

Promise 对象的结果

Promise 对象的结果可以通过 result 属性获取。如果 Promise 对象的状态是 fulfilled，则 result 属性保存的是 Promise 对象成功完成时返回的结果；如果 Promise 对象的状态是 rejected，则 result 属性保存的是 Promise 对象失败完成时抛出的错误对象。

class Promise {
  constructor(executor) {
    // ...

    const resolve = (result) => {
      if (this.state !== 'pending') return;

      this.state = 'fulfilled';
      this.result = result;
    };

    const reject = (error) => {
      if (this.state !== 'pending') return;

      this.state = 'rejected';
      this.result = error;
    };

    executor(resolve, reject);
  }

  // ...
}

Promise 对象的 then 方法

Promise 对象的 then 方法用于添加回调函数，以便在 Promise 对象完成时执行相应的操作。then 方法接受两个参数：

onFulfilled：在 Promise 对象成功完成时执行的回调函数。
onRejected：在 Promise 对象失败完成时执行的回调函数。

class Promise {
  constructor(executor) {
    // ...

    this.then = (onFulfilled, onRejected) => {
      return new Promise((resolve, reject) => {
        // ...
      });
    };
  }

  // ...
}

Promise 对象的 catch 方法

Promise 对象的 catch 方法是 then 方法的语法糖，专门用于处理 Promise 对象失败完成时的情况。catch 方法接受一个参数：

onRejected：在 Promise 对象失败完成时执行的回调函数。

class Promise {
  constructor(executor) {
    // ...

    this.catch = (onRejected) => {
      return this.then(undefined, onRejected);
    };
  }

  // ...
}

Promise 对象的 finally 方法

Promise 对象的 finally 方法用于在 Promise 对象完成时（无论成功完成还是失败完成）执行相应的操作。finally 方法接受一个参数：

onFinally：在 Promise 对象完成时执行的回调函数。

class Promise {
  constructor(executor) {
    // ...

    this.finally = (onFinally) => {
      return this.then(
        (result) => {
          onFinally();
          return result;
        },
        (error) => {
          onFinally();
          throw error;
        }
      );
    };
  }

  // ...
}