上傳下載

導(dǎo)入模塊

import request from '@ohos.request';

常量

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.MiscServices.Download。

網(wǎng)絡(luò)類型

下載支持自定義網(wǎng)絡(luò)類型，可以在DownloadConfig中通過networkType配置成以下網(wǎng)絡(luò)類型。

下載任務(wù)的錯誤碼

下載on('fail')7+事件的錯誤參數(shù)、 getTaskInfo9+返回值的failedReason字段取值。

下載任務(wù)暫停原因

下載相關(guān)getTaskInfo9+返回值的pausedReason字段取值。

下載任務(wù)狀態(tài)碼

下載相關(guān)getTaskInfo9+返回值的status字段取值。

request.uploadFile9+

uploadFile(context: BaseContext, config: UploadConfig): Promise<UploadTask>

上傳，異步方法，使用promise形式返回結(jié)果。通過on('fail')7+可獲取任務(wù)上傳時(shí)的錯誤信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見上傳下載錯誤碼。

示例：

let uploadTask;
let uploadConfig = {
  url: 'http://www.example.com', //需要手動替換為真實(shí)服務(wù)器地址
  header: { 'Accept': '*/*' },
  method: "POST",
  files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
  data: [{ name: "name123", value: "123" }],
};
try {
  request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => {
    uploadTask = data;
  }).catch((err) => {
      console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
  });
} catch (err) {
  console.error('err.code : ' + err.code + ', err.message : ' + err.message);
}

request.uploadFile9+

uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback<UploadTask>): void

上傳，異步方法，使用callback形式返回結(jié)果。通過on('fail')7+可獲取任務(wù)上傳時(shí)的錯誤信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見上傳下載錯誤碼。

示例：

let uploadTask;
let uploadConfig = {
  url: 'http://www.example.com', //需要手動替換為真實(shí)服務(wù)器地址
  header: { 'Accept': '*/*' },
  method: "POST",
  files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
  data: [{ name: "name123", value: "123" }],
};
try {
  request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => {
    if (err) {
        console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
        return;
    }
    uploadTask = data;
  });
} catch (err) {
  console.error('err.code : ' + err.code + ', err.message : ' + err.message);
}

request.upload(deprecated)

upload(config: UploadConfig): Promise<UploadTask>

上傳，異步方法，使用promise形式返回結(jié)果。

模型約束：此接口僅可在FA模型下使用

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

返回值：

示例：

let uploadTask;
let uploadConfig = {
  url: 'http://www.example.com', //需要手動替換為真實(shí)服務(wù)器地址
  header: { 'Accept': '*/*' },
  method: "POST",
  files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
  data: [{ name: "name123", value: "123" }],
};
request.upload(uploadConfig).then((data) => {
    uploadTask = data;
}).catch((err) => {
    console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
})

request.upload(deprecated)

upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void

上傳，異步方法，使用callback形式返回結(jié)果。

模型約束：此接口僅可在FA模型下使用

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

let uploadTask;
let uploadConfig = {
  url: 'http://www.example.com', //需要手動替換為真實(shí)服務(wù)器地址
  header: { 'Accept': '*/*' },
  method: "POST",
  files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
  data: [{ name: "name123", value: "123" }],
};
request.upload(uploadConfig, (err, data) => {
    if (err) {
        console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
        return;
    }
    uploadTask = data;
});

UploadTask

上傳任務(wù)，使用下列方法前，需要先獲取UploadTask對象。

on('progress')

on(type: 'progress', callback:(uploadedSize: number, totalSize: number) => void): void

訂閱上傳任務(wù)進(jìn)度監(jiān)聽，同步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

回調(diào)函數(shù)的參數(shù)

示例：

let upProgressCallback = (uploadedSize, totalSize) => {
    console.info("upload totalSize:" + totalSize + "  uploadedSize:" + uploadedSize);
};
 uploadTask.on('progress', upProgressCallback);

on('headerReceive')7+

on(type: 'headerReceive', callback: (header: object) => void): void

訂閱上傳任務(wù)HTTP標(biāo)頭監(jiān)聽，同步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

回調(diào)函數(shù)的參數(shù)：

示例：

let headerCallback = (headers) => {   
    console.info("upOnHeader headers:" + JSON.stringify(headers)
);
uploadTask.on('headerReceive', headerCallback);

on('complete' | 'fail')9+

on(type:'complete' | 'fail', callback: Callback<Array<TaskState>>): void;

訂閱上傳任務(wù)完成或失敗監(jiān)聽，同步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

回調(diào)函數(shù)的參數(shù):

示例：

let upCompleteCallback = (taskStates) => {
  for (let i = 0; i < taskStates.length; i++ ) {
     console.info("upOnComplete taskState:" + JSON.stringify(taskStates[i]));
  }
};
uploadTask.on('complete', upCompleteCallback);

let upFailCallback = (taskStates) => {
  for (let i = 0; i < taskStates.length; i++ ) {
    console.info("upOnFail taskState:" + JSON.stringify(taskStates[i]));
  }
};
uploadTask.on('fail', upFailCallback);

off('progress')

off(type: 'progress', callback?: (uploadedSize: number, totalSize: number) => void): void

刪除上傳任務(wù)進(jìn)度監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

let upProgressCallback = (uploadedSize, totalSize) => {
    console.info('Upload delete progress notification.' + 'totalSize:' + totalSize + 'uploadedSize:' + uploadedSize);
};
uploadTask.off('progress', upProgressCallback);

off('headerReceive')7+

off(type: 'headerReceive', callback?: (header: object) => void): void

刪除上傳任務(wù)HTTP標(biāo)頭監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

let headerCallback = (header) => {
    console.info(`Upload delete headerReceive notification. header: ${JSON.stringify(header)}`);
};
uploadTask.off('headerReceive', headerCallback);

off('complete' | 'fail')9+

off(type:'complete' | 'fail', callback?: Callback<Array<TaskState>>): void;

刪除上傳任務(wù)完成或失敗監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

let upCompleteCallback = (taskStates) => {
  console.info('Upload delete complete notification.');
  for (let i = 0; i < taskStates.length; i++ ) {
      console.info('taskState:' + JSON.stringify(taskStates[i]));
 }
};
uploadTask.off('complete', upCompleteCallback);
let upFailCallback = (taskStates) => {
  console.info('Upload delete fail notification.');
  for (let i = 0; i < taskStates.length; i++ ) {
    console.info('taskState:' + JSON.stringify(taskStates[i]));
  }
};
uploadTask.off('fail', upFailCallback);

delete9+

delete(): Promise<boolean>

移除上傳的任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

返回值：

示例：

uploadTask.delete().then((result) => {
    if (result) {
        console.info('Upload task removed successfully. ');
    } else {
        console.error('Failed to remove the upload task. ');
    }
}).catch((err) => {
    console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
});

delete9+

delete(callback: AsyncCallback<boolean>): void

移除上傳的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

uploadTask.delete((err, result) => {
    if (err) {
        console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
        return;
    }
    if (result) {
        console.info('Upload task removed successfully.');
    } else {
        console.error('Failed to remove the upload task.');
    }
});

remove(deprecated)

remove(): Promise<boolean>

移除上傳的任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

返回值：

示例：

uploadTask.remove().then((result) => {
    if (result) {
        console.info('Upload task removed successfully. ');
    } else {
        console.error('Failed to remove the upload task. ');
    }
}).catch((err) => {
    console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
});

remove(deprecated)

remove(callback: AsyncCallback<boolean>): void

移除上傳的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Upload

參數(shù)：

示例：

uploadTask.remove((err, result) => {
    if (err) {
        console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
        return;
    }
    if (result) {
        console.info('Upload task removed successfully.');
    } else {
        console.error('Failed to remove the upload task.');
    }
});

UploadConfig

上傳任務(wù)的配置信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.MiscServices.Upload。

TaskState9+

上傳任務(wù)信息，on('complete' | 'fail')和off('complete' | 'fail')接口的回調(diào)參數(shù)。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.MiscServices.Upload。

File

UploadConfig中的文件列表。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.MiscServices.Download。

RequestData

UploadConfig中的表單數(shù)據(jù)。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: 以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.MiscServices.Download。

request.downloadFile9+

downloadFile(context: BaseContext, config: DownloadConfig): Promise<DownloadTask>

下載，異步方法，使用promise形式返回結(jié)果。通過on('complete'|'pause'|'remove')可獲取任務(wù)下載時(shí)的狀態(tài)信息，包括任務(wù)完成、暫?；蛞瞥?。通過on('fail')可獲取任務(wù)下載時(shí)的錯誤信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見上傳下載錯誤碼。

示例：

let downloadTask;
try {
  request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => {
      downloadTask = data;
  }).catch((err) => {
      console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
  })
} catch (err) {
  console.error('err.code : ' + err.code + ', err.message : ' + err.message);
}

request.downloadFile9+

downloadFile(context: BaseContext, config: DownloadConfig, callback: AsyncCallback<DownloadTask>): void;

下載，異步方法，使用callback形式返回結(jié)果。通過on('complete'|'pause'|'remove')可獲取任務(wù)下載時(shí)的狀態(tài)信息，包括任務(wù)完成、暫停或移除。通過on('fail')可獲取任務(wù)下載時(shí)的錯誤信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見上傳下載錯誤碼。

示例：

let downloadTask;
try {
  request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap', 
  filePath: 'xxx/xxxxx.hap'}, (err, data) => {
      if (err) {
          console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
          return;
      }
      downloadTask = data;
  });
} catch (err) {
  console.error('err.code : ' + err.code + ', err.message : ' + err.message);
}

request.download(deprecated)

download(config: DownloadConfig): Promise<DownloadTask>

下載，異步方法，使用promise形式返回結(jié)果。

模型約束：此接口僅可在FA模型下使用

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

返回值：

示例：

let downloadTask;
request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => {
    downloadTask = data;
}).catch((err) => {
    console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
})

request.download(deprecated)

download(config: DownloadConfig, callback: AsyncCallback<DownloadTask>): void

下載，異步方法，使用callback形式返回結(jié)果。

模型約束：此接口僅可在FA模型下使用

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

let downloadTask;
request.download({ url: 'https://xxxx/xxxxx.hap', 
filePath: 'xxx/xxxxx.hap'}, (err, data) => {
    if (err) {
        console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
        return;
    }
    downloadTask = data;
});

DownloadTask

下載任務(wù)，使用下列方法前，需要先獲取DownloadTask對象，promise形式通過request.downloadFile9+獲取，callback形式通過request.downloadFile9+獲取。

on('progress')

on(type: 'progress', callback:(receivedSize: number, totalSize: number) => void): void

訂閱下載任務(wù)進(jìn)度監(jiān)聽，同步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

回調(diào)函數(shù)的參數(shù)：

示例：

let progresCallback = (receivedSize, totalSize) => {
    console.info("download receivedSize:" + receivedSize + " totalSize:" + totalSize);
};
downloadTask.on('progress', progresCallback);

off('progress')

off(type: 'progress', callback?: (receivedSize: number, totalSize: number) => void): void

刪除下載任務(wù)進(jìn)度監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

let progresCallback = (receivedSize, totalSize) => {
    console.info('Download delete progress notification.' + 'receivedSize:' + receivedSize + 'totalSize:' + totalSize);
};
downloadTask .off('progress',progresCallback);

on('complete'|'pause'|'remove')7+

on(type: 'complete'|'pause'|'remove', callback:() => void): void

訂閱下載任務(wù)相關(guān)的監(jiān)聽，異步方法，使用callback形式返回。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

let completeCallback = () => {
    console.info('Download task completed.');
};
downloadTask.on('complete', completeCallback);
let pauseCallback = () => {
    console.info('Download task pause.');
};
downloadTask.on('pause', pauseCallback);
let removeCallback = () => {
    console.info('Download task remove.');
};
downloadTask.on('remove', removeCallback);

off('complete'|'pause'|'remove')7+

off(type: 'complete'|'pause'|'remove', callback?:() => void): void

刪除下載任務(wù)相關(guān)的監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

let completeCallback = () => {
    console.info('Download delete complete notification.'); 
};
downloadTask.off('complete', completeCallback);
let pauseCallback = () => {
    console.info('Download delete pause notification.'); 
}; 
downloadTask.off('pause', pauseCallback); 
let removeCallback = () => {
    console.info('Download delete remove notification.'); 
}; 
downloadTask.off('remove', removeCallback);

on('fail')7+

on(type: 'fail', callback: (err: number) => void): void

訂閱下載任務(wù)失敗監(jiān)聽，同步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

回調(diào)函數(shù)的參數(shù)：

示例：

let failCallback = (err) => {
    console.info('Download task failed. Cause:' + err);
};
downloadTask.on('fail', failCallback);

off('fail')7+

off(type: 'fail', callback?: (err: number) => void): void

刪除下載任務(wù)失敗監(jiān)聽，同步方法。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

let failCallback = (err) => {
    console.info(`Download delete fail notification. err: ${err.message}`); 
};
downloadTask.off('fail', failCallback);

delete9+

delete(): Promise<boolean>

移除下載的任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.delete().then((result) => {
    if (result) {
        console.info('Download task removed.');
    } else {
        console.error('Failed to remove the download task.');
    }
}).catch ((err) => {
    console.error('Failed to remove the download task.');
});

delete9+

delete(callback: AsyncCallback<boolean>): void

移除下載的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.delete((err, result)=>{
    if(err) {
        console.error('Failed to remove the download task.');
        return;
    } 
    if (result) {
        console.info('Download task removed.');
    } else {
        console.error('Failed to remove the download task.');
    } 
});

getTaskInfo9+

getTaskInfo(): Promise<DownloadInfo>

查詢下載任務(wù)，異步方法，使用promise形式返回DownloadInfo里的信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.getTaskInfo().then((downloadInfo) => {    
    console.info('Download task queried. Data:' + JSON.stringify(downloadInfo))
}) .catch((err) => {
    console.error('Failed to query the download task. Cause:' + err)
});

getTaskInfo9+

getTaskInfo(callback: AsyncCallback<DownloadInfo>): void

查詢下載的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.getTaskInfo((err, downloadInfo)=>{
    if(err) {
        console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
    } else {
        console.info('download query success. data:'+ JSON.stringify(downloadInfo));
    }
});

getTaskMimeType9+

getTaskMimeType(): Promise<string>

查詢下載的任務(wù)的 MimeType，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.getTaskMimeType().then((data) => {    
    console.info('Download task queried. Data:' + JSON.stringify(data));
}).catch((err) => {
    console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err))
});

getTaskMimeType9+

getTaskMimeType(callback: AsyncCallback<string>): void;

查詢下載的任務(wù)的 MimeType，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.getTaskMimeType((err, data)=>{
    if(err) {
        console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
    } else {
        console.info('Download task queried. data:' + JSON.stringify(data));
    }
});

suspend9+

suspend(): Promise<boolean>

暫停下載任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.suspend().then((result) => {    
    if (result) {
         console.info('Download task paused. ');
    } else {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(result));
    }
}).catch((err) => {
    console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
});

suspend9+

suspend(callback: AsyncCallback<boolean>): void

暫停下載任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.suspend((err, result)=>{
    if(err) {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
        return;
    }
    if (result) {
         console.info('Download task paused. ');
    } else {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(result));
    }
});

restore9+

restore(): Promise<boolean>

重新啟動暫停的下載任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.restore().then((result) => {
    if (result) {
        console.info('Download task resumed.')
    } else {
        console.error('Failed to resume the download task. ');
    }
    console.info('Download task resumed.')
}).catch((err) => {
    console.error('Failed to resume the download task. Cause:' + err);
});

restore9+

restore(callback: AsyncCallback<boolean>): void

重新啟動暫停的下載任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.restore((err, result)=>{
    if (err) {
        console.error('Failed to resume the download task. Cause:' + err);
        return;
    } 
    if (result) {
        console.info('Download task resumed.');
    } else {
        console.error('Failed to resume the download task.');
    }
});

remove(deprecated)

remove(): Promise<boolean>

移除下載的任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.remove().then((result) => {
    if (result) {
        console.info('Download task removed.');
    } else {
        console.error('Failed to remove the download task.');
    }
}).catch ((err) => {
    console.error('Failed to remove the download task.');
});

remove(deprecated)

remove(callback: AsyncCallback<boolean>): void

移除下載的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.remove((err, result)=>{
    if(err) {
        console.error('Failed to remove the download task.');
        return;
    } 
    if (result) {
        console.info('Download task removed.');
    } else {
        console.error('Failed to remove the download task.');
    } 
});

query(deprecated)

query(): Promise<DownloadInfo>

查詢下載任務(wù)，異步方法，使用promise形式返回DownloadInfo里的信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.query().then((downloadInfo) => {    
    console.info('Download task queried. Data:' + JSON.stringify(downloadInfo))
}) .catch((err) => {
    console.error('Failed to query the download task. Cause:' + err)
});

query(deprecated)

query(callback: AsyncCallback<DownloadInfo>): void

查詢下載的任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.query((err, downloadInfo)=>{
    if(err) {
        console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
    } else {
        console.info('download query success. data:'+ JSON.stringify(downloadInfo));
    }
});

queryMimeType(deprecated)

queryMimeType(): Promise<string>

查詢下載的任務(wù)的 MimeType，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.queryMimeType().then((data) => {    
    console.info('Download task queried. Data:' + JSON.stringify(data));
}).catch((err) => {
    console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err))
});

queryMimeType(deprecated)

queryMimeType(callback: AsyncCallback<string>): void;

查詢下載的任務(wù)的 MimeType，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.queryMimeType((err, data)=>{
    if(err) {
        console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
    } else {
        console.info('Download task queried. data:' + JSON.stringify(data));
    }
});

pause(deprecated)

pause(): Promise<void>

暫停下載任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.pause().then((result) => {    
    if (result) {
         console.info('Download task paused. ');
    } else {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(result));
    }
}).catch((err) => {
    console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
});

pause(deprecated)

pause(callback: AsyncCallback<void>): void

暫停下載任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.pause((err, result)=>{
    if(err) {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
        return;
    }
    if (result) {
         console.info('Download task paused. ');
    } else {
        console.error('Failed to pause the download task. Cause:' + JSON.stringify(result));
    }
});

resume(deprecated)

resume(): Promise<void>

重新啟動暫停的下載任務(wù)，異步方法，使用promise形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

返回值：

示例：

downloadTask.resume().then((result) => {
    if (result) {
        console.info('Download task resumed.')
    } else {
        console.error('Failed to resume the download task. ');
    }
    console.info('Download task resumed.')
}).catch((err) => {
    console.error('Failed to resume the download task. Cause:' + err);
});

resume(deprecated)

resume(callback: AsyncCallback<void>): void

重新啟動暫停的下載任務(wù)，異步方法，使用callback形式返回結(jié)果。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

參數(shù)：

示例：

downloadTask.resume((err, result)=>{
    if (err) {
        console.error('Failed to resume the download task. Cause:' + err);
        return;
    } 
    if (result) {
        console.info('Download task resumed.');
    } else {
        console.error('Failed to resume the download task.');
    }
});

DownloadConfig

下載任務(wù)的配置信息。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download

DownloadInfo7+

下載任務(wù)信息， getTaskInfo9+接口的回調(diào)參數(shù)。

需要權(quán)限：ohos.permission.INTERNET

系統(tǒng)能力: SystemCapability.MiscServices.Download