Skip to content
On this page

ek.uploadFile

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

参数

参数类型默认值必填说明
urlstring服务器地址
filePathstring要上传文件资源的路径 (本地路径)
namestring文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容
headerObjectHTTP 请求的 Header
formDataObjectHTTP 请求中其他额外的 form data
timeoutnumber60000超时时间,单位为毫秒
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

成功返回

属性类型说明
datastring服务器返回的数据
statusCodenumber服务器返回的 HTTP 状态码
headerObject服务器返回的 HTTP Response Header

返回值

UploadTask

Example

ts
const chooseImage = async () => {
  const result = await ek.chooseImage({
    count: 1,
    sizeType: ['compressed'],
    sourceType: ['album']
  })

  const filePath = result.tempFilePaths[0]
  const key = filePath.substr(filePath.lastIndexOf('/') + 1)

  ek.uploadFile({
    url: 'https://example.com/upload',
    name: 'file',
    filePath,
    formData: {
      // cos auth
      key,
      success_action_status: 200,
      Signature: 'abcd...',
      'x-cos-security-token': 'abcd...',
      'Content-Type': ''
    },
    success: res => {
      const src = 'https://cdn.example.com/' + key
      // <img :src="src" />
    },
    fail: err => {
      console.log(err)
    }
  })
}