Skip to content

介绍

是什么?

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
schematic

Released under the MIT License.