介绍
@blinkmobile/evergreen-sdk 是一款适用于前端的 npm 包，可以帮助开发者轻松实现与 Bluemix Evergreen 服务器通信的功能。Bluemix Evergreen 是 IBM 公司提供的一项云服务，用于为企业级应用程序提供 API 管理和自动化工具，以简化开发工作，并确保更快的时间到市场。
该 npm 包使用 TypeScript 编写，具有良好的可读性和可维护性。
安装
该包可以使用 npm 或 yarn 进行安装：
--- ------- --------------------------
或
---- --- --------------------------
快速入门
创建一个 Evergreen 实例
在你的代码中导入 Evergreen，然后创建一个实例。你需要提供你的 Evergreen API 端点 URL，作为创建实例的第一个参数。第二个参数为可选的，用于配置请求。
------ - --------- - ---- -----------------------------
----- ------ - --- ------------------------------------------- -
-------- -
-------------- ------- -------------
-
---发送请求
可以在创建实例后，使用 client.get()、client.post()、client.put()、client.patch()、client.delete() 来调用 API。这些方法支持简易的 callback 风格或者是返回 promises。
-- -------- -- --------------------------- ------- --------- -- - --------------------------------- --- -- ------- ----- ---------------------------- - -------- ------- ----------- ---
处理错误
如果请求失败，返回的错误将简单地包装在一个 EvergreenError 实例中，它扩展了 JavaScript 的原生 Error 对象。
--- -
----- -------- - ----- ------------------------------------
- ----- ----- -
-- ---- ---------- --------------- -
------------------------ --- ----- ------------------ -----------------
- ---- -
---------------------------
-
-高级用法
配置多个请求
默认情况下，@blinkmobile/evergreen-sdk 使用 Node.js 的全局 http 和 https 模块来实现请求，这对于大多数用户来说是完全足够的。
但是，对于需要特定配置的用户（例如通过代理连接到 Evergreen、需要 SSL 证书身份验证等等），可以使用自定义的 http 和 https 实例将其传递给 Evergreen 构造函数的第三个参数中。
------ - --------- - ---- -----------------------------
------ ---- ---- -------
------ ----- ---- --------
----- ------ - --- ------------------------------------------- -
-------- -
-------------- ------- -------------
-
-- -
----- -----
------ -----
---处理自定义 HTTP 错误
Evergreen 在响应的 HTTP 头部中会包含自定义错误代码。如果你需要对这些代码做特殊处理，可以在请求后的 Promise 或者 callback 中处理。
--------------------------- ----- ---- -- -
-- ----- -
-- --------------- --- ---- -
----------------------- --- --------
- ---- -- --------------- --- ---- -
--------------------------- -- ------ -----------
- ---- -
---------------------- ------ -----------------------
-
- ---- -
-----------------------
-
---自定义认证
默认情况下，Evergreen 使用 OAuth2 JWT 令牌进行身份验证，如果需要，也可以将自己的认证方式提供给 Evergreen 构造函数的第二个参数上的 headers 对象中。
------ - --------- - ---- -----------------------------
----- ------ - --- ------------------------------------------- -
-------- -
------------------- ------ ----- -----
-
---结论
@blinkmobile/evergreen-sdk 是一款非常方便的 npm 包，可用于帮助开发者轻松实现与 Bluemix Evergreen 服务器通信的功能。它易于使用，易于阅读和维护，具有灵活的配置和自定义选项。因此，我们鼓励开发者尝试使用该库来加速他们的 Bluemix Evergreen 开发过程。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/600668f8d9381d61a3540f63