# DownloadTask 对象
# DownloadTask.onProgressUpdate
downLoadFile的调用结果在通过回调传递的同时会返回一个downloadTask对象，通过onProgressUpdate方法监听下载进度。
# 支持说明
| 应用能力 | Android | iOS | PC | 预览效果 |
|---|---|---|---|---|
| 小程序 | 3.3.0 | 3.3.0 | 3.4.0 | 扫码预览 用BoosHi扫码或PC端点击 |
| 网页应用 | X | X | X | / |
# 输入
function listener 下载进度变化事件的监听函数
# 输出
回调函数返回对象的属性：
| 名称 | 数据类型 | 描述 |
|---|---|---|
| progress | number | 下载进度 |
| totalBytesWritten | number | 已经下载的数据长度，单位 byte |
| totalBytesExpectedToWrite | number | 预期需要下载的数据总长度，单位 byte |
# 示例代码
const downloadTask = bz.downloadFile({"url":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.jj20.com%2Fup%2Fallimg%2Ftp05%2F19100120461512E-0-lp.jpg&refer=http%3A%2F%2Fimg.jj20.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1640079653&t=22aafb14cb145c11fc833022d61507c5"});
downloadTask.onProgressUpdate(function(res) {
console.log(JSON.stringify(res));
});
1
2
3
4
2
3
4
回调函数返回对象示例：
{
"totalBytesWritten": 208788,
"progress": 100,
"totalBytesExpectedToWrite": 208788
}
1
2
3
4
5
2
3
4
5
# DownloadTask.offProgressUpdate()
downloadFile的调用结果在通过回调传递的同时会返回一个downloadTask对象，可以通过该对象的offProgressUpdate方法取消监听下载。
# 支持说明
| 应用能力 | Android | iOS | PC | 预览效果 |
|---|---|---|---|---|
| 小程序 | 3.3.0 | 3.3.0 | 3.4.0 | 扫码预览 用BoosHi扫码或PC端点击 |
| 网页应用 | X | X | X | / |
# 输入
function listener 取消下载进度变化事件的监听函数
# 输出
无
# 示例代码
const downloadTask = bz.downloadFile({"url":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.jj20.com%2Fup%2Fallimg%2Ftp05%2F19100120461512E-0-lp.jpg&refer=http%3A%2F%2Fimg.jj20.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1640079653&t=22aafb14cb145c11fc833022d61507c5"});
downloadTask.offProgressUpdate(function(res) {
console.log(res)
});
1
2
3
4
2
3
4
# DownloadTask.abort()
downloadFile的调用结果在通过回调传递的同时会返回一个downloadTask对象，可以通过该对象的abort方法中断请求任务。
# 支持说明
| 应用能力 | Android | iOS | PC | 预览效果 |
|---|---|---|---|---|
| 小程序 | 3.3.0 | 3.3.0 | 3.4.0 | 扫码预览 用BoosHi扫码或PC端点击 |
| 网页应用 | X | X | X | / |
# 输入
无
# 输出
无
# 示例代码
const downloadTask2 = bz.downloadFile({"url":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fimg.jj20.com%2Fup%2Fallimg%2Ftp05%2F19100120461512E-0-lp.jpg&refer=http%3A%2F%2Fimg.jj20.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1640079653&t=22aafb14cb145c11fc833022d61507c5"});
downloadTask2.abort(function(res) {
console.log(JSON.stringify(res));
});
1
2
3
4
2
3
4