uniapp开发app框架在提升开发效率中的独特优势与应用探索
324
2024-07-14
基础库1.3.9开始支持,iOS版本2.1.23,Android版本2.1.38
request(Object object)
利用原生Api发起HTTP网络请求,执行后返回 RequestTask 对象。
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
url | string | 是 | 开发者服务器接口地址 | |
data | string/object/ArrayBuffer | 否 | 请求的参数 | |
header | Object | 否 | 设置请求的 header,header 中不能设置 Referer。content-type 默认为 application/json | |
method | string | GET | 否 | HTTP 请求方法 |
timeout | number | 否 | 超时时间,单位为毫秒 | |
dataType | string | json | 否 | 返回的数据格式 |
responseType | string | text | 否 | 响应的数据类型 |
forceCellularNetwork | boolean | false | 否 | wifi下使用移动网络发送请求(仅安卓支持) |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.method 的合法值
值 | 说明 |
---|---|
OPTIONS | HTTP 请求 OPTIONS |
GET | HTTP 请求 GET |
HEAD | HTTP 请求 HEAD |
POST | HTTP 请求 POST |
PUT | HTTP 请求 PUT |
DELETE | HTTP 请求 DELETE |
TRACE | HTTP 请求 TRACE |
CONNECT | HTTP 请求 CONNECT |
object.dataType 的合法值
值 | 说明 |
---|---|
json | 返回的数据为 JSON,返回后会对返回的数据进行一次 JSON.parse |
其他 | 不对返回的内容进行 JSON.parse |
object.responseType 的合法值
值 | 说明 |
---|---|
text | 响应的数据为文本 |
arraybuffer | 响应的数据为 ArrayBuffer |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
data | string/object/ArrayBuffer | 开发者服务器返回的数据 |
statusCode | number | 开发者服务器返回的 HTTP 状态码 |
header | Object | 开发者服务器返回的 HTTP Response Header |
示例代码
ft.request({ url: 'test.php', // 仅为示例,并非真实的接口地址 data: { x: '', y: '' }, header: { 'content-type': 'application/json' // 默认值 }, success(res) { console.log(res.data) }}) 已复制代码
基础库2.4.2开始支持,iOS版本2.13.59,Android版本2.13.34
RequestTask.abort()
中断请求任务
示例代码
const task = ft.request({ // some params})// 中断请求task.abort() 已复制代码
基础库2.4.2开始支持,iOS版本2.13.59,Android版本2.13.34
RequestTask.onHeadersReceived(function callback)
监听 HTTP Response Header 事件,会比请求完成事件更早。
参数
function callback
Header Received 事件的回调函数
回调函数参数
Object res
属性 | 类型 | 说明 |
---|---|---|
header | Object | 开发者服务器返回的 HTTP Response Header |
基础库2.4.2开始支持,iOS版本2.13.59,Android版本2.13.34
RequestTask.offHeadersReceived(function callback)
取消监听 HTTP Response Header 事件。
参数
function callback
Header Received 事件的回调函数
基础库3.2.3开始支持,iOS版本2.43.7,Android版本2.43.7
RequestTask.onChunkReceived(function callback)
监听 Chunk Received 事件,当接收到新的 chunk 时触发
参数
function callback
Chunk Received 事件的回调函数
回调函数参数
Object res
属性 | 类型 | 说明 |
---|---|---|
data | ArrayBuffer | 请求返回的 chunk buffer |
基础库3.2.3开始支持,iOS版本2.43.7,Android版本2.43.7
RequestTask.offChunkReceived(function callback)
取消监听 Chunk Received 事件
参数
function callback
Chunk Received 事件的回调函数
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~