tt.uploadFile
从基础库 1.0.0 开始支持
将本地文件上传到网络。 网络相关的 API 在使用前需要配置域名白名单。请参考网络请求使用说明。客户端发起一个 HTTPS POST 请求,其中 content-type 为 multipart/form-data
参数
名称 | 数据类型 | 属性 | 默认值 | 描述 |
---|---|---|---|---|
url | string | required | 目标地址 | |
filePath | string | required | 本地文件路径 | |
name | string | required | HTTP 请求的文件名 | |
header | object | optional | {'content-type': 'multipart/form-data'} | 请求 Header |
formData | object | optional | null | 请求额外参数 |
success | function | optional | 接口调用成功的回调函数 | |
fail | function | optional | 接口调用失败的回调函数 | |
complete | function | optional | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.success 回调函数
参数
Object res
名称 | 数据类型 | 描述 |
---|---|---|
data | string | 返回数据 |
statusCode | number | 返回 HTTP 状态码 |
返回值
代码示例
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();
}