下載檔案資源到本地，客戶端直接發起一個 HTTP GET 請求，返回檔案的本地臨時路徑。

OBJECT 引數說明

注：檔案的臨時路徑，在應用本次啟動期間可以正常使用，如需持久儲存，需在主動呼叫 uni.saveFile，才能在應用下次啟動時訪問得到。

success 返回引數說明

示例

uni.downloadFile({
    url: 'https://www.example.com/file/test', //僅為示例，並非真實的資源
    success: function (res) {
        if (res.statusCode === 200) {
            console.log('下載成功');
        }
    }
});
 

返回值

返回一個 downloadTask 物件，通過 downloadTask，可監聽上傳進度變化事件，以及取消上傳任務。

downloadTask 物件的方法列表

onProgressUpdate 返回引數說明

示例

const downloadTask = uni.downloadFile({
    url: 'http://www.example.com/file/test', //僅為示例，並非真實的資源
    success: function (res) {
        if (res.statusCode === 200) {
            console.log('下載成功');
        }
    }
});

downloadTask.onProgressUpdate(function (res) {
    console.log('下載進度' + res.progress);
    console.log('已經下載的資料長度' + res.totalBytesWritten);
    console.log('預期需要下載的資料總長度' + res.totalBytesExpectedToWrite);

    // 測試條件，取消下載任務。
    if (res.progress > 50) {
        downloadTask.abort();
    }
});