在前端开发中，我们经常会遇到需要重试某些异步操作的情况，比如网络请求失败、数据加载失败等。这时候，一个可靠的重试机制就显得非常必要了。在 Node.js 社区中，有许多不错的重试库，而其中一个叫做 @amphibian/promise-retry 的 npm 包就提供了一个简单的重试实现。
简介
@amphibian/promise-retry 是一个基于 Promise 的 JavaScript 重试库。它提供了一个函数，可以将需要重试的异步函数包装起来，然后自动重试指定次数，直到成功为止。如果重试次数用尽，它将会抛出一个错误，以便你随时处理。
安装
你可以通过 npm 来安装它，命令如下：
npm install @amphibian/promise-retry
使用
示例 1: 最简单的使用方法
最简单的使用方式是将要重试的函数作为 @amphibian/promise-retry 函数的参数传递进去，然后指定重试次数即可，例如：
-- -------------------- ---- -------
----- ----- - ------------------------------------
-------- ---- -
------ --- ----------------- ------- -- -
----- --------- - --------------
-- ---------- - ---- -
-------------------
- ---- -
----------------
-
---
-
--------- - -------- - --
-------------- -- -
--------------------
--
---------- -- -
-----------------
---在这个例子中，我们定义了一个 fn 函数，它会生成随机数并返回一个 Promise。如果随机数大于 0.5，则 Promise 将成功，否则将失败并返回一个字符串 'Error'。我们使用 @amphibian/promise-retry 来包装 fn 函数，并指定重试次数为 5 次。这意味着，如果 fn 函数在前 5 次失败了，@amphibian/promise-retry 将自动尝试重新执行，直到成功或重试次数用尽为止。
你也可以将 fn 函数放在另一个模块中，然后在主模块中引用并传递它作为 @amphibian/promise-retry 函数的参数：
-- -------------------- ---- -------
----- ----- - ------------------------------------
----- -- - -----------------------
--------- - -------- - --
-------------- -- -
--------------------
--
---------- -- -
-----------------
---
示例 2: 指定重试间隔时间
@amphibian/promise-retry 还支持指定重试间隔时间，即每次重试之间的间隔时间。这可以帮助减轻服务器压力，或防止短时间内多次请求服务器。你可以通过指定 backoff 和 minTimeout 选项来设置重试间隔时间。例如：
-- -------------------- ---- ------- --------- - -------- -- ----------- ----- -------- -- -- -------------- -- - -------------------- -- ---------- -- - ----------------- ---
这个例子中，我们指定重试次数为 5 次，并设置了最小的重试间隔时间为 1 秒。它还指定了 backoff 选项为 2，这意味着每次重试之间的间隔时间将会是上一次重试的两倍。
示例 3: 自定义判断重试的条件
默认情况下，@amphibian/promise-retry 会自动重试任何 Promise 异常，包括常见的网络错误、超时错误等。但是，你可以通过自定义 shouldRetry 函数来控制重试的行为。例如：
-- -------------------- ---- -------
-------- ---------------- -
-- --------------- --- ---- -
------ -----
- ---- -- --------------- -- --- -- -------------- - ---- -
------ -----
-
------ ------
-
--------- - -------- -- ----------- --
-------------- -- -
--------------------
--
---------- -- -
-----------------
---
这个例子中，我们定义了一个 shouldRetry 函数，该函数将在出现异常时被调用。在 shouldRetry 函数中，我们可以根据异常的状态码等信息来决定是否应该重试。在这个例子中，如果出现状态码为 429 的异常或状态码在 500 到 599 之间的异常，我们将进行重试。
总结
@amphibian/promise-retry 是一个简单易用的 JavaScript 重试库，它可以帮助我们实现多个异步函数重试功能。它具有用户友好的 API，可以通过多种选项进行自定义。如果你需要在前端项目中处理各种异常情况，可以考虑使用它。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/151048