dlt.uploadFile

简介

将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求，其中 content-type 为 multipart/form-data。

参数

Object object

属性	类型	默认值	必填	说明	最低版本
url	string		是	请求的地址
header	string		否	设置请求的 header，JSON string
formData	string/Object		否	HTTP 请求中其他额外的 form data，如果为 Object，请确保 value 值是字符串类型
filePath	string		否	指定文件下载后存储的路径 (相对路径)	3.0.0 版本后支持
timeout	number	60000	否	超时时间，单位为毫秒。默认值为 60000。	3.0.0 版本后支持
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
response	string	服务端返回的信息
success	string	true-成功

object.fail 回调函数

参数

Object res

属性	类型	说明
errCode	string	错误码
errMsg	string	错误信息
success	string	false-失败

errMsg 说明

错误信息	说明
UploadFile fail, url is not startsWith http:U001	上传失败，url 不合法
UploadFile fail, Exception_"+t.toString()+":U002	上传失败，出现异常
UploadFile fail, file:" + localPath + " is not exist:U003	上传失败，上传的文件地址不存在
UploadFile fail, parse: header/formData error:U004	上传失败，header 或者 formData 有错误
UploadFile fail, onFailure_${e.toString()}:U005	上传失败
UploadFile fail, onResponse_${e.toString()}:U006	上传失败

示例代码

// pages/index/index.js

Page({
  uploadFile() {
    dlt.uploadFile({
      url: "xxx",
      filePath: tempFilePaths[0],
      formData: {
        user: "test",
      },
      success(res) {
        console.log(res);
      },
      fail(res) {
        console.error(res);
      },
    });
  },
});