介绍
是什么?
uni-ajax 是一款基于 promise 的轻量级 uni-app 网络请求库。参考了 Axios 的使用方式封装默认的 request 方法,但更轻量,更灵活,且保留原有的核心。解决了原有请求方法在 uni-app 项目开发中的一些不方便,更切合企业开发的实际需求,开箱即用,配置简单。
如果你有 Axios 的使用经验,相信很快上手(有使用上的区别)。如果没有用过 Axios,你也通过这份文档,带你简单上手并深入使用 uni-ajax。
特性
- 💿 支持 Promise API
- 🏷 支持 TypeScript 开发
- 🎛 拦截请求和响应
- 📦 自定义配置请求实例
- 📡 多种 Method 方法请求
- 🖇 支持 RequestTask 操作
链接
文档说明
这份文档是适用于 2.3.0
以上版本,如果您 uni-ajax
低于此版本,该文档内容会对应不上,您可查看更新日志查看变更对照。
在文档中您会看到一些版本标记,不同颜色代表不同的意思:
- 新增 表示在此版本的新增功能
- 调整 表示在此版本做了调整
- 废弃 表示在此版本已废弃
思考
uni-ajax 是基于 Promise 开发的。自然继承了 Promise 链式调用,我们的发起请求时的配置参数从调用到响应,都是从上至下传递。我们不妨思考一下,不同位置链中的函数都是可以对我们的数据操作,所以这就给我们更多扩展性和灵活性,如传值到拦截器、动态处理请求配置、根据响应结果自定义返回内容。
Promise 链式调用示例
js
Promise.resolve(0)
.then(n => n + 1) // 0 + 1
.then(n => n + 2) // 1 + 2
.then(n => n + 3) // 3 + 3
.then(n => console.log(n)) // 6