tt.uploadFile

从基础库 1.0.0 开始支持

将本地文件上传到网络。 网络相关的 API 在使用前需要配置域名白名单。请参考网络请求使用说明。客户端发起一个 HTTPS POST 请求,其中 content-typemultipart/form-data


参数

名称数据类型属性默认值描述
urlstringrequired目标地址
filePathstringrequired本地文件路径
namestringrequiredHTTP 请求的文件名
headerobjectoptional{'content-type': 'multipart/form-data'}请求 Header
formDataobjectoptionalnull请求额外参数
successfunctionoptional接口调用成功的回调函数
failfunctionoptional接口调用失败的回调函数
completefunctionoptional接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

名称数据类型描述
datastring返回数据
statusCodenumber返回 HTTP 状态码

返回值

UploadTask对象


代码示例

let task = tt.uploadFile({
  url: "someuploadurl",
  filePath: tempFilePath,
  name: "file",
  success(res) {
    if (res.statusCode === 200) {
      console.log(`uploadFile调用成功 ${res.data}`);
    }
  },
  fail(res) {
    console.log(`uploadFile调用失败`);
  }
});

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

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