swan.uploadFile

请参考使用注意事项进行开发。

解释：将本地资源上传到开发者服务器，客户端发起一个 HTTPS POST 请求，其中content-type为multipart/form-data
如页面通过 swan.chooseImage 等接口获取到一个本地资源的临时文件路径后，可通过此接口将本地资源上传到指定服务器。

方法参数

Object object

object 参数说明

属性名类型必填默认值说明

url

String

是

开发者服务器 url

filePath

String

是

要上传文件资源的路径

name

String

是

文件对应的 key ，开发者在服务器端通过这个 key 可以获取到文件二进制内容

header

Object

否

HTTP 请求 Header ， header 中不能设置 Referer

formData

Object

否

HTTP 请求中其他额外的 form data

success

Function

否

接口调用成功的回调函数

fail

Function

否

接口调用失败的回调函数

complete

Function

否

接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数类型说明

data

String

开发者服务器返回的数据

statusCode

Number

开发者服务器返回的 HTTP 状态码

fail 返回值参数说明

  • Android
错误码说明

201

解析失败，请检查调起协议是否合法

202

解析失败，请检查参数是否正确

1001

执行失败

  • iOS
错误码说明

202

解析失败，请检查参数是否正确

1

解析失败，请检查参数是否正确

示例

跳转编辑工具

在开发者工具中打开

在 WEB IDE 中打开

扫码体验

代码示例

百度智能小程序

请使用百度APP扫码

图片示例

swan.uploadFile - 图2

代码示例

  • SWAN
  • JS
  1. <view class="wrap">
  2.     <view class="card-area">
  3.         <view class="display-area">
  4.             <view s-if="{{filePath}}" bindtap="chooseImage">
  5.                 <image class="image-items" src="{{filePath}}" mode="aspectFit"></image>
  6.             </view>
  7.             <view s-else bindtap="chooseImage">
  8.                 <image class="img" src="https://b.bdstatic.com/searchbox/icms/searchbox/img/plus.png"></image>
  9.                 <view class="title">添加图片文件</view>
  10.             </view>
  11.         </view>
  12.         <view class="button-area">
  13.             <button type="primary" bindtap="uploadFile">点击上传</button>
  14.         </view>
  15.     </view>
  16. </view>

返回值：
返回一个uploadTask对象，通过uploadTask，可监听上传进度变化事件，以及取消上传任务。

Bug & Tip

  • Tip：uploadFile 上传文件大小限制为 25M 。