简介
engage 是一个 Node.js 的 npm 包，它提供了一种便捷的方式来管理和调用 RESTful APIs。它支持灵活的配置和多种缓存策略，可以在 Node.js 服务端以及浏览器端使用。
安装
在使用 engage 之前，你需要先安装 Node.js 环境。然后，在你的项目中安装 engage：
npm install engage -S
基本用法
下面是一个简单的 engage 实例，它获取一个 GitHub 用户的信息：
-- -------------------- ---- -------
----- ------ - ------------------
----- ------- - -
-------- -------------------------
-------- -
-------------- ------- --------------------------
--
--
----- ------ - --- ----------------
----- ----------- - ----- ---------- -- -
----- -------- - ----- ---------------------------------
------ --------------
--
---------------------------------- -- -
------------------
---------------- -- -
---------------------
---在这个例子中，我们先创建了一个 Engage 实例，并传入了一些基本的配置，比如请求基础 URL 和请求头。然后，我们定义了一个异步函数 getUserInfo，它使用 engage.get 方法来获取指定用户的信息。最后，我们调用 getUserInfo 函数，并在返回的 Promise 中打印结果或捕获错误。
高级用法
缓存
engage 支持多种缓存策略，包括内存缓存和 Redis 缓存。你可以使用 cache 选项来启用缓存：
-- -------------------- ---- -------
----- ------- - -
-------- -------------------------
-------- -
-------------- ------- --------------------------
--
------ -
------ ---------
---- ---- -- -----------
--
--在这个例子中，我们启用了一个内存缓存，并设置了缓存过期时间为 300 秒。engage 还支持使用 Redis 作为缓存的存储后端，详见官方文档。
重试
如果请求失败了，engage 会自动尝试重新执行请求，直到达到最大重试次数为止。你可以使用 retries 选项来设置最大重试次数：
const options = {
baseURL: 'https://api.github.com',
headers: {
Authorization: 'Bearer your-github-access-token',
},
retries: 3,
};在这个例子中，我们设置了最大重试次数为 3。如果请求失败，engage 会自动尝试再次执行请求，最多尝试 3 次。
拦截器
如果你需要在请求发出或响应返回时做一些操作，可以使用 engage 的拦截器功能。engage 支持请求拦截器和响应拦截器。你可以使用 requestInterceptors 和 responseInterceptors 选项来添加拦截器：
-- -------------------- ---- -------
----- ------- - -
-------- -------------------------
-------- -
-------------- ------- --------------------------
--
--------------------- -
---------- -- -
-- ------------
--------------------- ----- -----------------------------------------
------ ---------
--
--
--在这个例子中，我们添加了一个响应拦截器，在响应返回时打印响应时间。
总结
engage 是一个非常方便的 Node.js npm 包，它提供了多种功能和配置选项，使得你能够轻松地管理和调用 RESTful APIs。在本文中，我们简单介绍了 engage 的基本用法和高级用法，希望能够对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066e25a563576b7b1ecf10