• Taro.uploadFile(param)
    • 参数
      • object param
    • 返回值
      • Promise<object res> promise
    • 示例代码
    • API支持度

    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服务器的返回数据

    示例代码

    1. import Taro from '@tarojs/taro'
    2. const uploadTask = Taro.uploadFile(params).then(...)

    API支持度

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