Taro.uploadFile(param)
将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求,其中 content-type 为 multipart/form-data。使用前请注意阅读相关说明。
使用方式同 wx.uploadFile
,支持 Promise
化使用。
参数
object param
Property | Type | Description |
---|
url | string | 开发者服务器地址 |
filePath | string | 要上传文件资源的路径 |
name | string | 文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容 |
[header] | object | HTTP 请求 Header,Header 中不能设置 Referer |
[formData] | object | HTTP 请求中其他额外的 form data |
[success()] | function | 接口调用成功的回调函数 |
[fail()] | function | 接口调用失败的回调函数 |
[complete()] | function | 接口调用结束的回调函数(调用成功、失败都会执行) |
返回值
Promise<object res> promise
Name | Type | Description |
---|
promise.headersReceive(callback) | function | 绑定接收到http header的回调 |
promise.progress(callback) | function | 绑定请求进度更新的回调 |
promise.abort() | function | 中断请求 |
res.statusCode | number | 请求的返回状态码 |
res.data | any | 服务器的返回数据 |
示例代码
import Taro from '@tarojs/taro'
const uploadTask = Taro.uploadFile(params).then(...)
API支持度
API | 微信小程序 | H5 | React Native | 支付宝小程序 | 百度小程序 |
---|
Taro.uploadFile | ✔️ | ✔️ | ️ | ✔️ | ✔️ |