Skip to main content

my.uploadFile

uploadFile

my.uploadFile là API dùng để upload file từ máy lên server.

Lưu ý

Chỉ thực hiện được việc upload các đường dẫn tạm thời của file ví dụ đường dẫn từ api chooseImage, downloadFile.

Quan trọng

Bạn cần phải thêm tên miền trong phần Cài đặt chung của ứng dụng trên Tini Console trước khi sử dụng các Networking API và Webview. Xem phần hướng dẫn tại đây.

Quét mã để trải nghiệm​

Xem code mẫu trên Tini Studio

Demo​

Trải nghiệm thử với trình giả lập bên dưới

Sample Code​

Example bên dưới lấy ra 1 hình từ gallery và upload lên http://httpbin.org/post

<view>
  <block-header title="Usage" description="Upload a file" />
  <view class="block-content">
    <button class="button-full" onTap="onUploadFile">Upload Image</button>
  </view>
</view>
Page({
  data: {
    url: undefined
  },
  onUploadFile() {
    my.chooseImage({
      count: 1,
      success: (res) => {
        const path = res.filePaths[0];
        console.log(path);
        my.uploadFile({
          url: 'http://httpbin.org/post',
          fileType: 'image/jpeg',
          fileName: 'file',
          filePath: path,
          success: (res) => {
            console.log(res);
            my.alert({ title: 'Upload success' });
          },
          fail: function (res) {
            console.log(res);
            my.alert({ title: 'Upload fail' });
          }
        });
      }
    });
  }
});

API Params​

Để cấu hình việc gọi network, bạn cần truyền object với các thuộc tính sau:

Thuộc tínhBắt buộcMô tả
urlstring✓Đường dẫn của server muốn upload
fileNamestring✓Tên file của như sử dụng làm key trong form data, server sẽ lấy ra file từ field này
filePathstring✓Đường dẫn tạm thời của file
formDataFormDataCác field khác của form cần send khi upload file
fileTypestring✓Mime của file ví dụ image/png. Hiện chỉ support imag, videos, và audio (image / video / audio)
headersObjectCấu hình headers khi thực hiện gọi network.
successFunctionCallback function khi việc upload file thành công.
failFunctionCallback function khi việc upload file thất bại.
completeFunctionCallback function khi việc upload file kết thúc cho dù thành công hay thất bại.

Success Callback function payload​

Callback function payload​

Thuộc tínhKiểu dữ liệuMô tả
dataStringDữ liệu đươc trả về từ server upload

Các lỗi hay gặp khi upload file.​

  • File không tồn tại -> do đường dẫn không đúng.
  • Upload fail từ server-> có thể file quá lớn, hoặc ko có permission. 1 số server yêu cầu truyền authorization token, nên khi gọi uploadFile phải truyền thêm headers.
  • Trong formData có thể gửi giá trị base64 nhưng không nên lạm dụng vì sẽ khiến payload của việc upload tăng lên nhiều và việc upload có thể mất nhiều thời gian hơn.
  • Hiện chỉ cho upload file image, audio và video, và chỉ upload đươc 1 file/lần.