更新记录

2.6.0（2025-06-07） 下载此版本

• 移除 fetcher 属性获取请求任务 详情
• 新增支持使用 AbortController 取消请求 详情

2.5.1（2023-01-16） 下载此版本

• 精简代码，体积更小，性能提升
• 废弃封装请求任务方法和 xhr 属性 详情
• 新增 fetcher 属性获取请求任务 详情
• 移除回调函数属性 success / fail / complete 详情

2.4.6（2022-12-01） 下载此版本

• 新增自定义响应内容类型 CustomResponse 详情
• 修改自定义请求配置类型 CustomConfig 详情
• 优化插件市场安装引入路径 详情
• 优化创建请求类工厂函数

平台兼容性

uni-app

其他

✨ 特性

• 支持 Promise API
• 支持 TypeScript 开发
• 拦截请求和响应
• 自定义配置请求实例
• 多种 Method 方法请求
• 支持 RequestTask 操作

🍟 文档

uniajax.ponjs.com

🥗 安装

插件市场

在插件市场右上角选择 使用HBuilder X 导入插件 或者 下载插件ZIP

NPM

# 如果您的项目是HBuilder X创建的，根目录又没有package.json文件的话，请先执行如下命令：
# npm init -y

# 安装
npm install uni-ajax

# 更新
npm update uni-ajax

🥐 实例

新建 ajax.js 文件（文件名可自定义）用于处理拦截器、接口根地址、默认配置等，详细配置请查看文档

// 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                                     // 导出创建后的实例

🥪 使用

请求方法

// 常规方法
ajax()

// 请求方法别名
ajax.get()
ajax.post()
ajax.put()
ajax.delete()

取消请求

const controller = new AbortController()
ajax({ signal: controller.signal })

controller.abort()  // 取消请求

其他属性方法

ajax.defaults       // 全局默认配置
ajax.config         // 当前实例配置
ajax.getURL(config) // 获取实例请求地址