使用说明
uni.request
是用来发送网络请求的,可以请求各种 HTTP 接口。它是一个全局的 API,在 uni-app
的所有平台都可使用。
API 结构
uni.request
的基本结构如下:
javascript
uni.request({
url: 'https://example.com/request', // 服务器接口地址
data: {
// 要发送给服务器的数据
},
header: {
// 设置请求的 header
},
method: "GET", // 默认为 GET,有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT
dataType: 'json', // 如果设为 json,会尝试对返回的数据做一次 JSON.parse
responseType: 'text', // 设置响应的数据类型。合法值:text、arraybuffer
success: function (res) {
// 请求成功的处理逻辑
},
fail: function (err) {
// 请求失败的处理逻辑
},
complete: function () {
// 请求完成的处理逻辑(请求成功或失败时都会被调用)
}
});
示例代码
下面是一个使用 uni.request
的示例:
javascript
uni.request({
url: 'https://example.com/api', // 你的接口地址
data: {
text: 'uni-app'
},
method: 'POST',
success: res => {
console.log(res.data);
},
fail: err => {
console.error('请求接口失败:', err);
},
complete: () => {
// 无论请求成功或失败都会执行
console.log('请求完成');
}
});
在这个示例中,通过 POST 方法向指定的 URL 发送数据。如果请求成功,success
回调将被调用,并且 res.data
将包含服务器返回的数据。如果请求失败,fail
回调将被调用,并且 err
参数将包含错误信息。不论成功或失败,complete
回调都将最终被执行。
注意:所有的请求过程都是异步的,success
、fail
和 complete
回调函数将在请求过程结束后被调用。
更多详情请查看 uni-app 官方文档。