proxmis 是一个 JavaScript 库，可以用于在前端 Web 应用程序中使用 Promise 包装器的 RPC 调用。它可以减轻我们在前端 Web 应用程序中使用远程过程调用时的许多麻烦。和其他类似的框架相比，proxmis 具有非常好的通用性和灵活性，因此在社区中受到了广泛的追捧。
本篇文章将为大家详细介绍 proxmis 的使用方法。我们将深入探讨 proxmis 提供的功能，为大家实现高度耦合的 Web 应用程序提供帮助。
安装
要使用 proxmis，我们需要在项目中安装它。我们可以通过 npm 来安装 proxmis：
$ npm install proxmis
使用
安装完 proxmis 后，我们只需要用 import 或 require 命令来将 proxmis 引入项目即可。
-- -------------------- ---- -------
------ ------- ---- ----------
----- --- - ---------
----- ----------------------------
----- -----
-------- ------
-------- -
-------------- ------- - - ------------
-
---
-----------------
--------- -- -----------------
---------- -- ------------------上面这个例子将 proxmis 初始化后，调用了 get 方法。这个代码块代码的含义是向 '/users' 这个地址发起请求并打印出结果或错误。
这里我们解释一下上面代码块里的参数：
base: 请求地址的通用前缀，默认值是 '/'。mock: 是否开启 mock 模式，默认值是 false。如果开启，proxmis 将在发起请求前，使用本地数据快速返回模拟数据。timeout: 请求超时时间，默认值是 0，表示不限制超时时间。headers: 请求头部信息。
除了 get 请求，proxmis 还支持以下方法：post、put、delete、head、options、patch
api.post('/users', user)
.then(res => console.log(res))
.catch(err => console.log(err));api.put('/users', user)
.then(res => console.log(res))
.catch(err => console.log(err));api.delete('/users', id)
.then(res => console.log(res))
.catch(err => console.log(err));api.head('/users')
.then(res => console.log(res))
.catch(err => console.log(err));api.options('/users')
.then(res => console.log(res))
.catch(err => console.log(err));api.patch('/users', user)
.then(res => console.log(res))
.catch(err => console.log(err));钩子
如果我们想在请求前或请求后做修改，proxmis 提供了两个钩子函数：before 和 after。
-- -------------------- ---- -------
------------------- -- -
-------------- - -
-------------- ------- - - ------------
-
--------------------- -------
------ -------
---
-------------------- ------ -- -
------------------ ---------- --------------
------------------ ------- ------
------ ---------
---
-----------------
--------- -- -----------------
---------- -- ------------------这里我们可以在 before 函数中修改请求头，或者在 after 函数中处理响应数据和错误信息。
mock
在开发调试阶段，我们希望不依赖于真实数据源。这时可以使用 proxmis 的 mock 功能。
我们只需要将配置中的 mock 参数设置为 true，proxmis 会自动在请求的 URL 对应的目录下搜索同名的 mock 文件并返回数据。
-- -------------------- ---- -------
----- --- - ---------
----- ----------------------------
----- -----
-------- ------
-------- -
-------------- ------- - - ------------
-
---
-- - ------------- ------------ ----- ----------------- -------
-----------------
--------- -- -----------------
---------- -- ------------------在 '/mocks/users.js' 文件中，我们可以指定该接口返回何种数据和响应状态。
-- -------------------- ---- -------
-------------- - ----- ---- -- -
------ -
----- --
-------- -----
----- -
-
--- --
----- ------
--
-
--- --
----- ------
-
-
--
--错误处理
在请求时可能会发生错误，比如服务器无法响应、网络出现问题等等，这时需要通过 catch 方法来捕获错误。
api.get('/articles')
.then(res => {
console.log(res);
})
.catch(error => {
console.log(error);
});proxmis 也支持针对性的错误处理，在初始化时可通过 errorHandlers 参数传入错误处理函数。
-- -------------------- ---- -------
----- --- - ---------
----- ----------------------------
-------------- -
---- -- -- -
---------------- --------
--
---- -- -- -
---------------- --------
-
-
---
-----------------
--------- -- -----------------
---------- -- ------------------注意，只有当请求出错并且 HTTP 状态码与 errorHandlers 中定义的代码匹配时，错误处理函数才会被调用。
超时处理
proxmis 还支持请求超时。可以在配置选项中通过 timeout 参数来设置请求超时时间。
const api = Proxmis({
base: 'http://localhost:8080/api',
timeout: 1000
});
api.get('/users')
.then(res => console.log(res))
.catch(err => console.log(err));请求如果在超时时间内未完成，catch 方法将捕获一个 timeout 错误。
总结
proxmis 在前端开发中提供了很好的解决方案。在本篇文章中，我们详细介绍了 proxmis 的使用方法，并针对其提供的功能进行了细致的解释。希望本文能够对大家在实际项目开发中的前端工作带来帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5f69490fa9b7065299ccb7e8