uni.request网络请求

最新推荐文章于 2025-06-19 16:36:21 发布

原创最新推荐文章于 2025-06-19 16:36:21 发布 · 4.5k 阅读

2 ·

CC 4.0 BY-SA版权

本文介绍了uni.request()方法的使用，包括OBJECT参数的详细说明，数据转换规则，特别是不同HTTP方法下数据处理方式，如GET和POST的数据序列化处理。并提供了一个示例来展示如何使用uni.request进行网络请求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

uni.request(OBJECT)

OBJECT 参数说明

参数名	类型	必填	默认值	说明
url	String	是		开发者服务器接口地址
data	Object/String/ArrayBuffer	否		请求的参数
header	Object	否		设置请求的 header，header 中不能设置 Referer。
method	String	否	GET	(需大写）有效值：OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType	String	否	json	如果设为 json，会尝试对返回的数据做一次 JSON.parse
responseType	String	否	text	设置响应的数据类型。合法值：text、arraybuffer
success	Function	否		收到开发者服务成功返回的回调函数
fail	Function	否		接口调用失败的回调函数
complete	Function	否		接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数	类型	说明
data	Object/String/ArrayBuffer	开发者服务器返回的数据
statusCode	Number	开发者服务器返回的 HTTP 状态码
header	Object	开发者服务器返回的 HTTP Response Header

data 数据说明
最终发送给服务器的数据是 String 类型，如果传入的 data 不是 String 类型，会被转换成 String

对于 GET 方法，会将数据转换为 query string。例如 { name: ‘li’, age: 19 } 转换后的结果是 name=li&age=19
对于 POST 方法且 header['content-type'] 为 application/json 的数据，会进行 JSON 序列化。
对于 POST 方法且 header['content-type'] 为 application/x-www-form-urlencoded 的数据，会将数据转换为 query string。

示例

uni.request({
			    url: 'https://www.example.com/request', //仅为示例，并非真实接口地址。
			    data: {
			        name: 'name',
			        age: 19
			    },
			    header: {
			        'custom-header': 'hello' //自定义请求头信息
			    },
			    success: function (res) {
			        console.log(res.data);
			    }
			});

返回值
返回一个 requestTask 对象，通过 requestTask，可中断请求任务。
requestTask 对象的方法列表

方法	说明
about	中断请求任务
offHeadersReceived	取消监听 HTTP Response Header 事件
onHeadersReceived	监听 HTTP Response Header 事件。会比请求完成事件更早

const requestTask = uni.request({
			    url: 'https://www.example.com/request', //仅为示例，并非真实接口地址。
			    data: {
			        name: 'name',
			        age: 18
			    },
			    success: function (res) {
			        console.log(res.data);
			    }
			});
			 
			requestTask.abort();   // 中断请求任务