Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 9e491925 编写于 作者: J Jeam_wang 提交者： Jeam.wang
浏览文件
操作

上传下载异常错误码及api9接口更新 

Signed-off-by: NJeam_wang <jeam.wangwei@huawei.com>
上级 9a01c582
隐藏空白更改
内联 并排
Showing with 656 addition and 5 deletion
zh-cn/application-dev/reference/apis/js-apis-request.md
浏览文件 @ 9e491925
......@@ -33,6 +33,7 @@ var config = {
在开发stage模型下的应用程序时，不涉及属性标识 "cleartextTraffic"。
下载服务器需要支持http协议的header方法，能够通过content-length获取下载数据大小，否则下载任务失败，可通过[on('fail')<sup>7+</sup>)](#onfail7)查看失败原因。
## 常量
......@@ -53,6 +54,8 @@ var config = {
| ERROR_INSUFFICIENT_SPACE<sup>7+</sup> | number | 是 | 否 | 存储空间不足。 |
| ERROR_TOO_MANY_REDIRECTS<sup>7+</sup> | number | 是 | 否 | 网络重定向过多导致的错误。 |
| ERROR_UNHANDLED_HTTP_CODE<sup>7+</sup> | number | 是 | 否 | 无法识别的HTTP代码。 |
| ERROR_OFFLINE<sup>9+</sup> | number | 是 | 否 | 网络未连接。 |
| ERROR_UNSUPPORTED_NETWORK_TYPE<sup>9+</sup> | number | 是 | 否 | 网络类型不匹配。 |
| ERROR_UNKNOWN<sup>7+</sup> | number | 是 | 否 | 未知错误。 |
| PAUSED_QUEUED_FOR_WIFI<sup>7+</sup> | number | 是 | 否 | 下载被暂停并等待WLAN连接，因为文件大小超过了使用蜂窝网络的会话允许的最大值。 |
| PAUSED_UNKNOWN<sup>7+</sup> | number | 是 | 否 | 未知原因导致暂停下载。 |
......@@ -73,6 +76,8 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt;
此接口仅可在FA模型下使用
> **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -116,6 +121,8 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
此接口仅可在FA模型下使用
> **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -152,6 +159,8 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
上传，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -195,6 +204,8 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
上传，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -227,6 +238,103 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
});
```
## request.uploadFile<sup>9+</sup>
uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
上传，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |
**错误码：**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcodes-request.md)。
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例：**
```js
let uploadTask;
let uploadConfig = {
url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: { filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" },
data: { name: "name123", value: "123" },
};
request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => {
uploadTask = data;
}).catch((err) => {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
});
```
## request.uploadFile<sup>9+</sup>
uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
上传，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
| callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 否 | 回调函数，异步返回UploadTask对象。 |
**错误码：**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcodes-request.md)。
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例：**
```js
let uploadTask;
let uploadConfig = {
url: 'https://patch',
header: { key1: "value1", key2: "value2" },
method: "POST",
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }],
};
request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => {
if (err) {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
return;
}
uploadTask = data;
});
```
## UploadTask
上传任务，使用下列方法前，需要先获取UploadTask对象。
......@@ -455,6 +563,8 @@ remove(): Promise&lt;boolean&gt;
移除上传的任务，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -486,6 +596,8 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
移除上传的任务，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
......@@ -513,6 +625,70 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
```
### delete<sup>9+</sup>
delete(): Promise&lt;boolean&gt;
移除上传的任务，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 移除任务是否成功。true：成功，false：不成功。 |
**示例：**
```js
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));
});
```
### delete<sup>9+</sup>
delete(callback: AsyncCallback&lt;boolean&gt;): void
移除上传的任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |
**示例：**
```js
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.');
}
});
```
## UploadConfig
**需要权限**：ohos.permission.INTERNET
......@@ -543,21 +719,21 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
**需要权限**：ohos.permission.INTERNET
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Download
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| filename | string | 否 | multipart提交时，请求头中的文件名。 |
| name | string | 否 | multipart提交时，表单项目的名称，缺省为file。 |
| filename | string | 是 | multipart提交时，请求头中的文件名。 |
| name | string | 是 | multipart提交时，表单项目的名称，缺省为file。 |
| uri | string | 是 | 文件的本地存储路径。<br/>支持“dataability”和“internal”两种协议类型，但“internal”仅支持临时目录，示例：<br/>dataability:///com.domainname.dataability.persondata/person/10/file.txt<br/>internal://cache/path/to/file.txt |
| type | string | 否 | 文件的内容类型，默认根据文件名或路径的后缀获取。 |
| type | string | 是 | 文件的内容类型，默认根据文件名或路径的后缀获取。 |
## RequestData
**需要权限**：ohos.permission.INTERNET
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Download
**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -571,6 +747,8 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
下载，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
此接口仅可在FA模型下使用
**需要权限**：ohos.permission.INTERNET
......@@ -607,6 +785,8 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v
下载，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
此接口仅可在FA模型下使用
**需要权限**：ohos.permission.INTERNET
......@@ -640,6 +820,8 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&
下载，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -675,6 +857,8 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l
下载，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -700,6 +884,94 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l
downloadTask = data;
});
```
## request.downloadFile<sup>9+</sup>
downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
下载，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |
**错误码：**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcodes-request.md)。
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 13400001 | File operation error. |
| 13400002 | Bad file path. |
| 13400003 | Task manager service error. |
**示例：**
```js
let downloadTask;
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));
})
```
## request.downloadFile<sup>9+</sup>
downloadFile(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void;
下载，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
| callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 否 | 下载接口的回调函数。 |
**错误码：**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcodes-request.md)。
| 错误码ID | 错误码信息 |
| -------- | -------- |
| 13400001 | File operation error. |
| 13400002 | Bad file path. |
| 13400003 | Task manager service error. |
**示例：**
```js
let downloadTask;
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;
});
```
## DownloadTask
下载任务。
......@@ -899,6 +1171,8 @@ remove(): Promise&lt;boolean&gt;
移除下载的任务，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-2)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -930,6 +1204,8 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
移除下载的任务，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-3)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -963,6 +1239,8 @@ query(): Promise&lt;DownloadInfo&gt;
查询下载任务，异步方法，使用promise形式返回DownloadInfo里的信息。
> **说明：** 从API Version 9开始废弃，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -989,6 +1267,8 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
查询下载的任务，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -1018,6 +1298,8 @@ queryMimeType(): Promise&lt;string&gt;
查询下载的任务的 MimeType，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -1045,6 +1327,8 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
查询下载的任务的 MimeType，异步方法，使用callback形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9-1)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -1074,6 +1358,8 @@ pause(): Promise&lt;void&gt;
暂停下载任务，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[suspend<sup>9+</sup>](#suspend9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -1103,6 +1389,8 @@ pause(): Promise&lt;void&gt;
pause(callback: AsyncCallback&lt;void&gt;): void
> **说明：** 从API Version 9开始废弃，建议使用[suspend<sup>9+</sup>](#suspend9-1)替代。
暂停下载任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
......@@ -1138,6 +1426,8 @@ resume(): Promise&lt;void&gt;
重新启动暂停的下载任务，异步方法，使用promise形式返回结果。
> **说明：** 从API Version 9开始废弃，建议使用[restore<sup>9+</sup>](#restore9)替代。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
......@@ -1168,6 +1458,8 @@ resume(): Promise&lt;void&gt;
resume(callback: AsyncCallback&lt;void&gt;): void
> **说明：** 从API Version 9开始废弃，建议使用[restore<sup>9+</sup>](#restore9-1)替代。
重新启动暂停的下载任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
......@@ -1197,6 +1489,310 @@ resume(callback: AsyncCallback&lt;void&gt;): void
```
### delete<sup>9+</sup>
delete(): Promise&lt;boolean&gt;
移除下载的任务，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 移除任务是否成功。 |
**示例：**
```js
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.');
});
```
### delete<sup>9+</sup>
delete(callback: AsyncCallback&lt;boolean&gt;): void
移除下载的任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |
**示例：**
```js
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.');
}
});
```
### getTaskInfo<sup>9+</sup>
getTaskInfo(): Promise&lt;DownloadInfo&gt;
查询下载任务，异步方法，使用promise形式返回DownloadInfo里的信息。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |
**示例：**
```js
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)
});
```
### getTaskInfo<sup>9+</sup>
query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
查询下载的任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |
**示例：**
```js
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));
}
});
```
### getTaskMimeType<sup>9+</sup>
getTaskMimeType(): Promise&lt;string&gt;
查询下载的任务的 MimeType，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;string&gt; | 查询下载任务的MimeType。 |
**示例：**
```js
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))
});
```
### getTaskMimeType<sup>9+</sup>
getTaskMimeType(callback: AsyncCallback&lt;string&gt;): void;
查询下载的任务的 MimeType，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |
**示例：**
```js
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));
}
});
```
### suspend<sup>9+</sup>
suspend(): Promise&lt;void&gt;
暂停下载任务，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**返回值：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;void&gt; | 暂停下载任务是否成功。 |
**示例：**
```js
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));
});
```
### suspend<sup>9+</sup>
suspend(callback: AsyncCallback&lt;void&gt;): void
暂停下载任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 暂停下载任务的回调函数。 |
**示例：**
```js
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));
}
});
```
### restore<sup>9+</sup>
restore(): Promise&lt;void&gt;
重新启动暂停的下载任务，异步方法，使用promise形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 类型 | 说明 |
| -------- | -------- |
| Promise&lt;void&gt; | 重新启动暂停的下载任务是否成功。 |
**示例：**
```js
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);
});
```
### restore<sup>9+</sup>
restore(callback: AsyncCallback&lt;void&gt;): void
重新启动暂停的下载任务，异步方法，使用callback形式返回结果。
**需要权限**：ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download
**参数：**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
**示例：**
```js
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.');
}
});
```
## DownloadConfig
**需要权限**：ohos.permission.INTERNET
......
zh-cn/application-dev/reference/errorcodes/errorcodes-request.md 0 → 100644
浏览文件 @ 9e491925
# 上传下载错误码
## 13400001 文件操作异常
**错误信息**
File operation error.
**错误描述**
在调用uploadFile或downloadFile接口时，文件权限不足或操作失败。
**可能原因**
该错误码表示文件操作异常，可能原因文件权限不足。
**处理步骤**
请检查文件权限是否合理。
## 13400002 文件路径异常
**错误信息**
Bad file path.
**错误描述**
在调用uploadFile或downloadFile接口时，文件路径不合法。
**可能原因**
该错误码表示文件路径异常，可能原因文件路径错误。
**处理步骤**
请检查上传下载的文件路径是否正确。
## 13400003 服务异常
**错误信息**
Task manager service error.
**错误描述**
在调用downloadFile接口时，下载任务后台服务失败。
**可能原因**
该错误码表示服务异常，，可能原因任务创建失败
**处理步骤**
请检查任务配置是否正确。
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或