字節(jié)跳動(dòng)小程序開發(fā)API uploadFile

將本地文件上傳到網(wǎng)絡(luò)。

提示

網(wǎng)絡(luò)相關(guān)的 API 在使用前需要配置域名白名單。請參考網(wǎng)絡(luò)請求使用說明

提示

HTTP 請求 method 為POST

輸入

繼承標(biāo)準(zhǔn)對象輸入，擴(kuò)展屬性描述：

輸出

success返回對象參數(shù)的擴(kuò)展屬性：

本 API 的調(diào)用結(jié)果在通過回調(diào)傳遞的同時(shí)會(huì)返回一個(gè)uploadTask對象，可以通過該對象的abort方法中斷請求任務(wù)；通過onProgressUpdate方法監(jiān)聽下載進(jìn)度。

onProgressUpdate注冊的監(jiān)聽方法會(huì)收到一個(gè)object類型參數(shù)，該參數(shù)的屬性值有：

代碼示例

let task = tt.uploadFile({
    url: 'someuploadurl',
    filePath: tempFilePath,
    name: 'file',
    success (res) {
        if (res.statusCode === 200) {
            console.log(`uploadFile調(diào)用成功 ${res.data}`);
        }
    },
    fail (res) {
        console.log(`uploadFile調(diào)用失敗`);
    }
});

task.onProgressUpdate((res) => {
    this.setData({
        progress: res.progress
    });
});

if (someReason) {
    task.abort();
}

已知問題