uni-app 下载文件（四）

uni.downloadFile(OBJECT)
下载文件资源到本地，客户端直接发起一个 HTTP GET 请求，返回文件的本地临时路径。

OBJECT 参数说明

参数名 类型 必填 说明
url String 是 下载资源的 url
header Object 否 HTTP 请求 Header, header 中不能设置 Referer
success Function 否 下载成功后以 tempFilePath 的形式传给页面，res = {tempFilePath: '文件的临时路径'}
fail Function 否 接口调用失败的回调函数
complete Function 否 接口调用结束的回调函数（调用成功、失败都会执行）
注：文件的临时路径，在应用本次启动期间可以正常使用，如需持久保存，需在主动调用 uni.saveFile，才能在应用下次启动时访问得到。

success 返回参数说明

参数 类型 说明
tempFilePath String 临时文件路径，下载后的文件会存储到一个临时文件
statusCode Number 开发者服务器返回的 HTTP 状态码
示例

uni.downloadFile({

url: 'https://www.example.com/file/test', //仅为示例，并非真实的资源
success: function (res) {
    if (res.statusCode === 200) {
        console.log('下载成功');
    }
}

});
返回值

返回一个 downloadTask 对象，通过 downloadTask，可监听上传进度变化事件，以及取消上传任务。

downloadTask 对象的方法列表

方法 参数 说明 最低版本
onProgressUpdate callback 监听下载进度变化 *
abort   中断下载任务 *
onProgressUpdate 返回参数说明

参数 类型 说明
progress Number 下载进度百分比
totalBytesWritten Number 已经下载的数据长度，单位 Bytes
totalBytesExpectedToWrite Number 预期需要下载的数据总长度，单位 Bytes
示例

const downloadTask = uni.downloadFile({

url: 'http://www.example.com/file/test', //仅为示例，并非真实的资源
success: function (res) {
    if (res.statusCode === 200) {
        console.log('下载成功');
    }
}

});

downloadTask.onProgressUpdate(function (res) {

console.log('下载进度' + res.progress);
console.log('已经下载的数据长度' + res.totalBytesWritten);
console.log('预期需要下载的数据总长度' + res.totalBytesExpectedToWrite);

// 测试条件，取消下载任务。
if (res.progress > 50) {
    downloadTask.abort();
}

});