You've already forked guangan-mp
84 lines
1.8 KiB
Markdown
84 lines
1.8 KiB
Markdown
## ✨ 特性
|
|
|
|
- 支持 Promise API
|
|
- 支持 Typescript 开发
|
|
- 拦截请求和响应
|
|
- 自定义配置请求实例
|
|
- 多种 Method 方法请求
|
|
- 支持 RequestTask 操作
|
|
|
|
## 🍟 文档
|
|
|
|
**[uniajax.ponjs.com](https://uniajax.ponjs.com)**
|
|
|
|
## 🥗 安装
|
|
|
|
**插件市场**
|
|
|
|
在插件市场右上角选择 `使用HBuilder X 导入插件` 或者 `下载插件ZIP`
|
|
|
|
**NPM**
|
|
|
|
```bash
|
|
# 如果您的项目是HBuilder X创建的，根目录又没有package.json文件的话，请先执行如下命令：
|
|
# npm init -y
|
|
|
|
# 安装
|
|
npm install uni-ajax
|
|
|
|
# 更新
|
|
npm update uni-ajax
|
|
```
|
|
|
|
## 🥐 实例
|
|
|
|
新建 `ajax.js` 文件（文件名可自定义）用于处理拦截器、接口根地址、默认配置等，详细配置请[查看文档](https://uniajax.ponjs.com/instance/create.html)
|
|
|
|
```JavaScript
|
|
// ajax.js
|
|
|
|
import ajax from 'uni-ajax' // 引入 uni-ajax 模块
|
|
|
|
const instance = ajax.create(config) // 创建请求实例
|
|
|
|
instance.interceptors.request.use(onFulfilled, onRejected) // 添加请求拦截器
|
|
instance.interceptors.response.use(onFulfilled, onRejected) // 添加响应拦截器
|
|
|
|
export default instance // 导出创建后的实例
|
|
```
|
|
|
|
## 🥪 使用
|
|
|
|
**请求方法**
|
|
|
|
```JavaScript
|
|
// 常规方法
|
|
ajax()
|
|
|
|
// 请求方法别名
|
|
ajax.get()
|
|
ajax.post()
|
|
ajax.put()
|
|
ajax.delete()
|
|
```
|
|
|
|
**RequestTask**
|
|
|
|
```JavaScript
|
|
import ajax, { Fetcher } from 'uni-ajax'
|
|
|
|
const fetcher = new Fetcher()
|
|
ajax({ fetcher })
|
|
|
|
fetcher.abort() // 中断请求任务
|
|
const requestTask = await fetcher.source() // 获取请求任务对象
|
|
```
|
|
|
|
**其他属性方法**
|
|
|
|
```JavaScript
|
|
ajax.defaults // 全局默认配置
|
|
ajax.config // 当前实例配置
|
|
ajax.getURL(config) // 获取实例请求地址
|
|
```
|