sud.uploadFile
JS
sud.uploadFile (Object object)将本地资源上传到服务器
客户端发起一个 HTTP(S) POST 请求,其中 content-type 为 multipart/form-data。
参数
- Object object: 传入参数,具体的属性见下表
object 的属性说明:
| 属性 | 键值类型 | 是否必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 开发者服务器地址 |
| filePath | string | 是 | 要上传文件资源的路径 |
| name | string | 是 | 文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容 |
| header | Object | 否 | HTTP 请求的 Header,Header 中不能设置 Referer |
| formData | Object | 否 | HTTP 请求中其他额外的 form data |
| timeout | number | 否 | 超时时间,单位为毫秒 |
| success | function | 否 | 接口调用成功的回调函数 |
| fail | function | 否 | 接口调用失败的回调函数 |
| complete | function | 否 | 接口调用结束的回调函数 |
success 回调函数的参数
- Object res: 返回上传文件的信息
res 的属性说明:
| 属性 | 键值类型 | 说明 |
|---|---|---|
| data | string | 开发者服务器返回的数据 |
| statusCode | number | 服务器返回的 HTTP 状态码 |
返回值
- UploadTask: 返回一个可以监听上传进度变化事件,以及取消上传任务的对象