跳到主要内容
版本:1.x

Taro.uploadFile(param)

将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求,其中 content-type 为 multipart/form-data。使用前请注意阅读相关说明。

使用方式同 wx.uploadFile,支持 Promise 化使用。

参数

object param

PropertyTypeDescription
urlstring开发者服务器地址
filePathstring要上传文件资源的路径
namestring文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容
[header]objectHTTP 请求 Header,Header 中不能设置 Referer
[formData]objectHTTP 请求中其他额外的 form data
[success()]function接口调用成功的回调函数
[fail()]function接口调用失败的回调函数
[complete()]function接口调用结束的回调函数(调用成功、失败都会执行)

返回值

Promise<object res> promise

NameTypeDescription
promise.headersReceive(callback)function绑定接收到http header的回调
promise.progress(callback)function绑定请求进度更新的回调
promise.abort()function中断请求
res.statusCodenumber请求的返回状态码
res.dataany服务器的返回数据

示例代码

import Taro from '@tarojs/taro'

const uploadTask = Taro.uploadFile(params).then(...)

API支持度

API微信小程序H5React Native支付宝小程序百度小程序
Taro.uploadFile✔️✔️✔️✔️