tt.downloadFile

基础库版本 1.0.0 开始支持

下载网络文件到本地临时目录。单次下载允许的最大文件为 50MB。网络相关的 API 在使用前需要配置域名白名单。请参考网络请求使用说明。客户端直接发起一个 HTTPS GET 请求。 注意:请在服务端响应的 header 中指定合理的 Content-Type 字段,以保证客户端正确处理文件类型。


参数

Object object

名称数据类型属性默认值描述
urlstringrequired文件地址
headerobjectoptional请求 Header
successfunctionoptional接口调用成功的回调函数
failfunctionoptional接口调用失败的回调函数
completefunctionoptional接口调用结束的回调函数(成功、失败都会执行)

object.success 回调函数

参数

Object res

名称数据类型描述
tempFilePathstring文件本地路径
statusCodenumber返回 HTTP 状态码

返回值

DownloadTask对象。


代码示例

let task = tt.downloadFile({
  url: "somefileurl",
  success(res) {
    if (res.statusCode === 200) {
      console.log(`${res.tempFilePath}`);
    }
  },
  fail(res) {
    console.log(`downloadFile调用失败`);
  }
});

task.onProgressUpdate(res => {
  this.setData({
    progress: res.progress
  });
});

if (someReason) {
  task.abort();
}
点击纠错