跳到主要内容
版本:4.x

RequestTask

网络请求任务对象

支持情况:

参考文档

方法

abort

中断请求任务

支持情况:

参考文档

() => void

onHeadersReceived

监听 HTTP Response Header 事件。会比请求完成事件更早

支持情况:

参考文档

(callback: Callback) => void
参数类型说明
callbackCallbackHTTP Response Header 事件的回调函数

offHeadersReceived

取消监听 HTTP Response Header 事件

支持情况:

参考文档

(callback: Callback) => void
参数类型说明
callbackCallbackHTTP Response Header 事件的回调函数

onChunkReceived

监听 Transfer-Encoding Chunk Received 事件。当接收到新的chunk时触发。

支持情况:

参考文档

(callback: Callback) => void
参数类型说明
callbackCallbackTransfer-Encoding Chunk Received 事件的回调函数

offChunkReceived

移除 Transfer-Encoding Chunk Received 事件的监听函数

支持情况:

参考文档

(callback: Callback) => void
参数类型说明
callbackCallbackTransfer-Encoding Chunk Received 事件的回调函数

参数

onHeadersReceived

Callback

HTTP Response Header 事件的回调函数

(result: CallbackResult) => void
参数类型
resultCallbackResult

CallbackResult

参数类型说明
headerTaroGeneral.IAnyObject开发者服务器返回的 HTTP Response Header

onChunkReceived

Callback

Transfer-Encoding Chunk Received 事件的回调函数

(result: CallbackResult) => void
参数类型
resultCallbackResult

CallbackResult

开发者服务器每次返回新 chunk 时的 Response

参数类型说明
dataArrayBuffer返回的chunk buffer

示例代码

示例 1

回调函数(Callback)用法:

const requestTask = Taro.request({
url: 'test.php', //仅为示例,并非真实的接口地址
data: {
x: '' ,
y: ''
},
header: {
'content-type': 'application/json' // 默认值
},
success: function (res) {
console.log(res.data)
}
})
requestTask.abort()

示例 2

Promise 用法:

const requestTask = Taro.request({
url: 'test.php', //仅为示例,并非真实的接口地址
data: {
x: '' ,
y: ''
},
header: {
'content-type': 'application/json' // 默认值
},
success: function (res) {
console.log(res.data)
}
})
requestTask.then(res => {
console.log(res.data)
})
requestTask.abort()

示例 3

async/await 用法:

const requestTask = Taro.request(params)
const res = await requestTask
requestTask.abort()

API 支持度

API微信小程序百度小程序支付宝小程序抖音小程序QQ 小程序H5React NativeHarmonyHarmony hybrid
RequestTask✔️✔️✔️✔️✔️✔️✔️✔️
RequestTask.abort✔️✔️✔️
RequestTask.onHeadersReceived✔️✔️
RequestTask.offHeadersReceived✔️✔️
RequestTask.onChunkReceived✔️
RequestTask.offChunkReceived✔️