使用 promises-aplus-tests 进行 Promise 实现测试

在开发自定义的 Promise 实现时，确保其符合 Promises/A+ 规范 是至关重要的。promises-aplus-tests 是一个用于验证 Promise 实现是否符合该规范的测试工具。本文将指导你如何安装、配置并运行这些测试，帮助你实战检验自己的 Promise 实现。

安装测试工具

首先，需要安装 promises-aplus-tests。确保你已经安装了 Node.js 和 npm。

npm install promises-aplus-tests

添加测试命令

为了方便运行测试，可以在 package.json 文件中添加一个测试脚本。打开 package.json，在 scripts 部分添加以下内容：

{
  "scripts": {
    "test": "promises-aplus-tests MyPromise1.js"
  }
}

这样，你只需运行 npm test 即可执行测试。

编写自定义 Promise 实现

以下是一个简单的自定义 Promise 实现示例 MyPromise1.js。确保你的实现文件与测试命令中的文件名一致。

// MyPromise1.js
function MyPromise(executor) {
  this.state = 'pending';
  this.value = undefined;
  this.reason = undefined;
  this.onFulfilledCallbacks = [];
  this.onRejectedCallbacks = [];

  const resolve = (value) => {
    if (this.state === 'pending') {
      this.state = 'fulfilled';
      this.value = value;
      this.onFulfilledCallbacks.forEach((fn) => fn());
    }
  };

  const reject = (reason) => {
    if (this.state === 'pending') {
      this.state = 'rejected';
      this.reason = reason;
      this.onRejectedCallbacks.forEach((fn) => fn());
    }
  };

  try {
    executor(resolve, reject);
  } catch (error) {
    reject(error);
  }
}

MyPromise.prototype.then = function (onFulfilled, onRejected) {
  // 实现 then 方法
};

module.exports = MyPromise;

运行测试

安装并配置好测试工具后，可以通过以下命令运行测试：

npm test

测试结果将显示你的 Promise 实现是否符合 Promises/A+ 规范。如果有任何不符合的地方，测试工具会提供相应的错误信息，帮助你定位问题。

参考源码

如果你希望参考更多实现细节，可以访问我的 GitHub 仓库：

JavaScript-practise/ES6/Promises A+规范 at main · sumingcheng/JavaScript-practise

实战最佳实践

在实际开发中，实现一个符合 Promises/A+ 规范的 Promise 并非易事。以下是一些实战中的最佳实践建议：

保持状态不可变

一旦 Promise 的状态从 pending 变为 fulfilled 或 rejected，就不应再改变。这可以避免潜在的状态管理问题。

链式调用

确保 then 方法返回一个新的 Promise，以支持链式调用。这是 Promises/A+ 规范的核心之一。

MyPromise.prototype.then = function (onFulfilled, onRejected) {
  return new MyPromise((resolve, reject) => {
    // 实现链式调用逻辑
  });
};

错误处理

在执行 executor 函数时，捕获任何异常并调用 reject，确保错误能够被正确传递和处理。

try {
  executor(resolve, reject);
} catch (error) {
  reject(error);
}

通过遵循这些最佳实践，你可以构建一个健壮且符合规范的 Promise 实现。