API参考内容优化改进

Signed-off-by: N anyueling <anyueling@huawei.com>

API参考内容优化改进
Signed-off-by: N anyueling <anyueling@huawei.com>
624ebd36 · anyueling · e2b63e42 · 624ebd36
隐藏空白更改
内联并排

Showing with 273 addition and 279 deletion

zh-cn/application-dev/reference/apis/js-apis-request.md zh-cn/application-dev/reference/apis/js-apis-request.md +273 -279

未找到文件。
--- a/zh-cn/application-dev/reference/apis/js-apis-request.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-request.md
@@ -68,16 +68,12 @@ var config = {
 | SESSION_SUCCESSFUL<sup>7+</sup> | number | 是 | 否 | 下载会话已完成。 |


-## request.upload
+## request.uploadFile<sup>9+</sup>

-upload(config: UploadConfig): Promise&lt;UploadTask&gt;
+uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;

 上传，异步方法，使用promise形式返回结果。

-此接口仅可在FA模型下使用
-
->  **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload
@@ -86,16 +82,25 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt;

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |

+
 **返回值：**

  | 类型 | 说明 |
  | -------- | -------- |
  | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |

+**错误码：**
+以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
+
+  | 错误码ID | 错误信息 |
+  | -------- | -------- |
+  | 13400002 | Bad file path. |
+
 **示例：**
-  
+
  ```js
  let uploadTask;
  let uploadConfig = {
@@ -105,24 +110,20 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt;
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.upload(uploadConfig).then((data) => {
+  request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => {
      uploadTask = data;
  }).catch((err) => {
      console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
-  })
+  });
  ```


-## request.upload
+## request.uploadFile<sup>9+</sup>

-upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
+uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void

 上传，异步方法，使用callback形式返回结果。

-此接口仅可在FA模型下使用
-
->  **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload
@@ -131,11 +132,19 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
  | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数，异步返回UploadTask对象。 |

+**错误码：**
+以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
+
+  | 错误码ID | 错误信息 |
+  | -------- | -------- |
+  | 13400002 | Bad file path. |
+
 **示例：**
-  
+
  ```js
  let uploadTask;
  let uploadConfig = {
@@ -145,7 +154,7 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.upload(uploadConfig, (err, data) => {
+  request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => {
      if (err) {
          console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
          return;
@@ -153,13 +162,16 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
      uploadTask = data;
  });
  ```
-## request.upload<sup>9+</sup>

-upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
+## request.upload<sup>(deprecated)</sup>
+
+upload(config: UploadConfig): Promise&lt;UploadTask&gt;

 上传，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
+**模型约束**：此接口仅可在FA模型下使用
+
+>  **说明：** 从API Version 9开始不再维护，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。

 **需要权限**：ohos.permission.INTERNET

@@ -169,9 +181,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
-  

 **返回值：**

@@ -180,7 +190,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
  | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  let uploadConfig = {
@@ -190,21 +200,23 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.upload(globalThis.abilityContext, uploadConfig).then((data) => {
+  request.upload(uploadConfig).then((data) => {
      uploadTask = data;
  }).catch((err) => {
      console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
-  });
+  })
  ```


-## request.upload<sup>9+</sup>
+## request.upload<sup>(deprecated)</sup>

-upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
+upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void

 上传，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
+**模型约束**：此接口仅可在FA模型下使用
+
+>  **说明：** 从API Version 9开始不再维护，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。

 **需要权限**：ohos.permission.INTERNET

@@ -214,12 +226,11 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
  | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数，异步返回UploadTask对象。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  let uploadConfig = {
@@ -229,7 +240,7 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.upload(globalThis.abilityContext, uploadConfig, (err, data) => {
+  request.upload(uploadConfig, (err, data) => {
      if (err) {
          console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
          return;
@@ -238,37 +249,31 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
  });
  ```

+## request.upload<sup>(deprecated)</sup>

-## request.uploadFile<sup>9+</sup>
-
-uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
+upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;

 上传，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 9开始支持，从API Version 9开始不再维护，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| context | BaseContext | 是 | 基于应用程序的上下文。 |
-| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
-
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
+  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
+  

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |
-
-**错误码：**
-以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
-
-| 错误码ID | 错误信息 |
-| -------- | -------- |
-| 13400002 | Bad file path. |
+  | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |

 **示例：**

@@ -281,7 +286,7 @@ uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => {
+  request.upload(globalThis.abilityContext, uploadConfig).then((data) => {
      uploadTask = data;
  }).catch((err) => {
      console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
@@ -289,30 +294,25 @@ uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt
  ```


-## request.uploadFile<sup>9+</sup>
+## request.upload<sup>(deprecated)</sup>

-uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
+upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void

 上传，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 9开始支持，从API Version 9开始不再维护，建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| context | BaseContext | 是 | 基于应用程序的上下文。 |
-| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
-| callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数，异步返回UploadTask对象。 |
-
-**错误码：**
-以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
-
-| 错误码ID | 错误信息 |
-| -------- | -------- |
-| 13400002 | Bad file path. |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
+  | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
+  | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数，异步返回UploadTask对象。 |

 **示例：**

@@ -325,7 +325,7 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l
    files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
    data: [{ name: "name123", value: "123" }],
  };
-  request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => {
+  request.upload(globalThis.abilityContext, uploadConfig, (err, data) => {
      if (err) {
          console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
          return;
@@ -334,7 +334,6 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l
  });
  ```

-
 ## UploadTask

 上传任务，使用下列方法前，需要先获取UploadTask对象。
@@ -365,7 +364,7 @@ on(type: 'progress', callback:(uploadedSize: number, totalSize: number) =&gt; vo
 | totalSize | number | 是 | 上传文件的总大小，单位为KB。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.on('progress', function callback(uploadedSize, totalSize) {
@@ -399,7 +398,7 @@ on(type: 'headerReceive', callback:  (header: object) =&gt; void): void
 | header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.on('headerReceive', function callback(headers){   
@@ -433,7 +432,7 @@ on(type: 'headerReceive', callback:  (header: object) =&gt; void): void
 | taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.on('complete', function callback(taskStates) {
@@ -477,7 +476,7 @@ off(type:  'progress',  callback?: (uploadedSize: number, totalSize: number) =&g
 | totalSize | number | 是 | 上传文件的总大小，单位为KB。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.off('progress', function callback(uploadedSize, totalSize) {
@@ -511,7 +510,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
 | header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.off('headerReceive', function callback(headers) {
@@ -544,7 +543,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
 | taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 |

 **示例：**
-  
+
  ```js
  let uploadTask;
  uploadTask.off('complete', function callback(taskStates) {
@@ -562,15 +561,11 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
  );
  ```

-
-### remove
-
-remove(): Promise&lt;boolean&gt;
+### delete<sup>9+</sup>
+delete(): Promise&lt;boolean&gt;

 移除上传的任务，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload
@@ -582,10 +577,10 @@ remove(): Promise&lt;boolean&gt;
  | Promise&lt;boolean&gt; | 移除任务是否成功。true：成功，false：不成功。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
-  uploadTask.remove().then((result) => {
+  uploadTask.delete().then((result) => {
      if (result) {
          console.info('Upload task removed successfully. ');
      } else {
@@ -597,14 +592,12 @@ remove(): Promise&lt;boolean&gt;
  ```


-### remove
+### delete<sup>9+</sup>

-remove(callback: AsyncCallback&lt;boolean&gt;): void
+delete(callback: AsyncCallback&lt;boolean&gt;): void

 移除上传的任务，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-1)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload
@@ -616,10 +609,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |

 **示例：**
-  
+
  ```js
  let uploadTask;
-  uploadTask.remove((err, result) => {
+  uploadTask.delete((err, result) => {
      if (err) {
          console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
          return;
@@ -633,27 +626,29 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
  ```


-### delete<sup>9+</sup>
+### remove<sup>(deprecated)</sup>

-delete(): Promise&lt;boolean&gt;
+remove(): Promise&lt;boolean&gt;

 移除上传的任务，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 9开始不再维护，建议使用[delete<sup>9+</sup>](#delete9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;boolean&gt; | 移除任务是否成功。true：成功，false：不成功。 |
+  | Promise&lt;boolean&gt; | 移除任务是否成功。true：成功，false：不成功。 |

 **示例：**

  ```js
  let uploadTask;
-  uploadTask.delete().then((result) => {
+  uploadTask.remove().then((result) => {
      if (result) {
          console.info('Upload task removed successfully. ');
      } else {
@@ -665,27 +660,29 @@ delete(): Promise&lt;boolean&gt;
  ```


-### delete<sup>9+</sup>
+### remove<sup>(deprecated)</sup>

-delete(callback: AsyncCallback&lt;boolean&gt;): void
+remove(callback: AsyncCallback&lt;boolean&gt;): void

 移除上传的任务，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 9开始不再维护，建议使用[delete<sup>9+</sup>](#delete9-1)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Upload

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |

 **示例：**

  ```js
  let uploadTask;
-  uploadTask.delete((err, result) => {
+  uploadTask.remove((err, result) => {
      if (err) {
          console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
          return;
@@ -698,7 +695,6 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void
  });
  ```

-
 ## UploadConfig

 **需要权限**：ohos.permission.INTERNET
@@ -750,17 +746,12 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void
 | name | string | 是 | 表示表单元素的名称。 |
 | value | string | 是 | 表示表单元素的值。 |

+## request.downloadFile<sup>9+</sup>

-## request.download
-
-download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
+downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;

 下载，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
-
-此接口仅可在FA模型下使用
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -769,6 +760,7 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |

 **返回值：**
@@ -777,11 +769,20 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
  | -------- | -------- |
  | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |

+**错误码：**
+以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
+
+  | 错误码ID | 错误信息 |
+  | -------- | -------- |
+  | 13400001 | File operation error. |
+  | 13400002 | Bad file path. |
+  | 13400003 | Task manager service error. |
+
 **示例：**
-  
+
  ```js
  let downloadTask;
-  request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => {
+  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));
@@ -789,16 +790,12 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
  ```


-## request.download
+## request.downloadFile<sup>9+</sup>

-download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void
+downloadFile(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void;

 下载，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
-
-此接口仅可在FA模型下使用
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -807,14 +804,24 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
  | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 |

+**错误码：**
+以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
+
+  | 错误码ID | 错误信息 |
+  | -------- | -------- |
+  | 13400001 | File operation error. |
+  | 13400002 | Bad file path. |
+  | 13400003 | Task manager service error. |
+
 **示例：**
-  
+
  ```js
  let downloadTask;
-  request.download({ url: 'https://xxxx/xxxxx.hap', 
+  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));
@@ -824,13 +831,15 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v
  });
  ```

-## request.download<sup>9+</sup>
+## request.download<sup>(deprecated)</sup>

-download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
+download(config: DownloadConfig): Promise&lt;DownloadTask&gt;

 下载，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
+>  **说明：** 从API Version 9开始不再维护，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
+
+**模型约束**：此接口仅可在FA模型下使用

 **需要权限**：ohos.permission.INTERNET

@@ -840,7 +849,6 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |

 **返回值：**
@@ -850,10 +858,10 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&
  | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  request.download(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => {
+  request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => {
      downloadTask = data;
  }).catch((err) => {
      console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
@@ -861,13 +869,15 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&
  ```


-## request.download<sup>9+</sup>
+## request.download<sup>(deprecated)</sup>

-download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void;
+download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void

 下载，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
+>  **说明：** 从API Version 9开始不再维护，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
+
+**模型约束**：此接口仅可在FA模型下使用

 **需要权限**：ohos.permission.INTERNET

@@ -877,15 +887,14 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | context | BaseContext | 是 | 基于应用程序的上下文。 |
  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
  | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  request.download(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap', 
+  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));
@@ -895,44 +904,36 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l
  });
  ```

+## request.download<sup>(deprecated)</sup>

-## request.downloadFile<sup>9+</sup>
-
-downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
+download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;

 下载，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 9开始支持，从API Version 9开始不再维护，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| context | BaseContext | 是 | 基于应用程序的上下文。 |
-| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
+  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |
-
-**错误码：**
-以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
-
-| 错误码ID | 错误信息 |
-| -------- | -------- |
-| 13400001 | File operation error. |
-| 13400002 | Bad file path. |
-| 13400003 | Task manager service error. |
+  | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |

 **示例：**

  ```js
  let downloadTask;
-  request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => {
+  request.download(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => {
      downloadTask = data;
  }).catch((err) => {
      console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
@@ -940,38 +941,31 @@ downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadT
  ```


-## request.downloadFile<sup>9+</sup>
+## request.download<sup>(deprecated)</sup>

-downloadFile(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void;
+download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): void;

 下载，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 9开始支持，从API Version 9开始不再维护，建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| context | BaseContext | 是 | 基于应用程序的上下文。 |
-| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
-| callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 |
-
-**错误码：**
-以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)。
-
-| 错误码ID | 错误信息 |
-| -------- | -------- |
-| 13400001 | File operation error. |
-| 13400002 | Bad file path. |
-| 13400003 | Task manager service error. |
+  | context | BaseContext | 是 | 基于应用程序的上下文。 |
+  | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
+  | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 |

 **示例：**

  ```js
  let downloadTask;
-  request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap', 
+  request.download(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));
@@ -1012,7 +1006,7 @@ on(type: 'progress', callback:(receivedSize: number, totalSize: number) =&gt; vo
 | totalSize | number | 是 | 下载文件的总大小，单位为KB。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
  downloadTask.on('progress', function download_callback(receivedSize, totalSize) {
@@ -1047,7 +1041,7 @@ off(type: 'progress', callback?: (receivedSize: number, totalSize: number) =&gt;
 | totalSize | number | 是 | 下载文件的总大小。 |

 **示例：**
-  
+
  ```js
  downloadTask .off('progress', function download_callback(receivedSize, totalSize) {
      console.info("download receivedSize:" + receivedSize + " totalSize:" + totalSize);
@@ -1074,7 +1068,7 @@ on(type: 'complete'|'pause'|'remove', callback:() =&gt; void): void
  | callback | function | 是 | 回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
  downloadTask.on('complete', function callback() {
@@ -1102,7 +1096,7 @@ off(type: 'complete'|'pause'|'remove', callback?:() =&gt; void): void
  | callback | function | 否 | 回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
  downloadTask.off('complete', function callback() {
@@ -1136,7 +1130,7 @@ on(type: 'fail', callback: (err: number) =&gt; void): void
 | err | number | 是 | 下载失败的错误码，错误原因见[ERROR.*](#常量)。 |

 **示例：**
-  
+
  ```js 
  let downloadTask;
  downloadTask.on('fail', function callBack(err) {
@@ -1170,7 +1164,7 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void
 | err | number | 是 | 下载失败的错误码。错误原因见[ERROR_*](#常量)。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
  downloadTask.off('fail', function callBack(err) {
@@ -1179,15 +1173,12 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void
  );
  ```

+  ### delete<sup>9+</sup>

-### remove
-
-remove(): Promise&lt;boolean&gt;
+delete(): Promise&lt;boolean&gt;

 移除下载的任务，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-2)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1199,10 +1190,10 @@ remove(): Promise&lt;boolean&gt;
  | Promise&lt;boolean&gt; | 移除任务是否成功。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.remove().then((result) => {
+  downloadTask.delete().then((result) => {
      if (result) {
          console.info('Download task removed.');
      } else {
@@ -1214,14 +1205,12 @@ remove(): Promise&lt;boolean&gt;
  ```


-### remove
+### delete<sup>9+</sup>

-remove(callback: AsyncCallback&lt;boolean&gt;): void
+delete(callback: AsyncCallback&lt;boolean&gt;): void

 移除下载的任务，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[delete<sup>9+</sup>](#delete9-3)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1233,10 +1222,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.remove((err, result)=>{
+  downloadTask.delete((err, result)=>{
      if(err) {
          console.error('Failed to remove the download task.');
          return;
@@ -1250,14 +1239,12 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
  ```


-### query<sup>7+</sup>
+### getTaskInfo<sup>9+</sup>

-query(): Promise&lt;DownloadInfo&gt;
+getTaskInfo(): Promise&lt;DownloadInfo&gt;

 查询下载任务，异步方法，使用promise形式返回DownloadInfo里的信息。

->  **说明：** 从API Version 9开始废弃，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1269,10 +1256,10 @@ query(): Promise&lt;DownloadInfo&gt;
  | Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.query().then((downloadInfo) => {    
+  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)
@@ -1280,14 +1267,12 @@ query(): Promise&lt;DownloadInfo&gt;
  ```


-### query<sup>7+</sup>
+### getTaskInfo<sup>9+</sup>

-query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
+getTaskInfo(callback: AsyncCallback&lt;DownloadInfo&gt;): void

 查询下载的任务，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9-1)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1299,10 +1284,10 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
  | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.query((err, downloadInfo)=>{
+  downloadTask.getTaskInfo((err, downloadInfo)=>{
      if(err) {
          console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
      } else {
@@ -1312,14 +1297,12 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
  ```


-### queryMimeType<sup>7+</sup>
+### getTaskMimeType<sup>9+</sup>

-queryMimeType(): Promise&lt;string&gt;
+getTaskMimeType(): Promise&lt;string&gt;

 查询下载的任务的 MimeType，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1331,10 +1314,10 @@ queryMimeType(): Promise&lt;string&gt;
  | Promise&lt;string&gt; | 查询下载任务的MimeType。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.queryMimeType().then((data) => {    
+  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))
@@ -1342,14 +1325,12 @@ queryMimeType(): Promise&lt;string&gt;
  ```


-### queryMimeType<sup>7+</sup>
+### getTaskMimeType<sup>9+</sup>

-queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
+getTaskMimeType(callback: AsyncCallback&lt;string&gt;): void;

 查询下载的任务的 MimeType，异步方法，使用callback形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9-1)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1361,10 +1342,10 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
  | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.queryMimeType((err, data)=>{
+  downloadTask.getTaskMimeType((err, data)=>{
      if(err) {
          console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
      } else {
@@ -1374,14 +1355,12 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
  ```


-### pause<sup>7+</sup>
+### suspend<sup>9+</sup>

-pause(): Promise&lt;void&gt;
+suspend(): Promise&lt;boolean&gt;

 暂停下载任务，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[suspend<sup>9+</sup>](#suspend9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1390,13 +1369,13 @@ pause(): Promise&lt;void&gt;

  | 类型 | 说明 |
  | -------- | -------- |
-  | Promise&lt;void&gt; | 暂停下载任务是否成功。 |
+  | Promise&lt;boolean&gt; | 暂停下载任务是否成功。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.pause().then((result) => {    
+  downloadTask.suspend().then((result) => {    
      if (result) {
           console.info('Download task paused. ');
      } else {
@@ -1408,11 +1387,9 @@ pause(): Promise&lt;void&gt;
  ```


-### pause<sup>7+</sup>
-
-pause(callback: AsyncCallback&lt;void&gt;): void
+### suspend<sup>9+</sup>

->  **说明：** 从API Version 9开始废弃，建议使用[suspend<sup>9+</sup>](#suspend9-1)替代。
+suspend(callback: AsyncCallback&lt;boolean&gt;): void

 暂停下载任务，异步方法，使用callback形式返回结果。

@@ -1424,13 +1401,13 @@ pause(callback: AsyncCallback&lt;void&gt;): void

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;void&gt; | 是 | 暂停下载任务的回调函数。 |
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.pause((err, result)=>{
+  downloadTask.suspend((err, result)=>{
      if(err) {
          console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
          return;
@@ -1444,14 +1421,12 @@ pause(callback: AsyncCallback&lt;void&gt;): void
  ```


-### resume<sup>7+</sup>
+### restore<sup>9+</sup>

-resume(): Promise&lt;void&gt;
+restore(): Promise&lt;boolean&gt;

 重新启动暂停的下载任务，异步方法，使用promise形式返回结果。

->  **说明：** 从API Version 9开始废弃，建议使用[restore<sup>9+</sup>](#restore9)替代。
-
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download
@@ -1460,13 +1435,13 @@ resume(): Promise&lt;void&gt;

  | 类型 | 说明 |
  | -------- | -------- |
-  | Promise&lt;void&gt; | 重新启动暂停的下载任务是否成功。 |
+  | Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.resume().then((result) => {
+  downloadTask.restore().then((result) => {
      if (result) {
          console.info('Download task resumed.')
      } else {
@@ -1479,11 +1454,9 @@ resume(): Promise&lt;void&gt;
  ```


-### resume<sup>7+</sup>
-
-resume(callback: AsyncCallback&lt;void&gt;): void
+### restore<sup>9+</sup>

->  **说明：** 从API Version 9开始废弃，建议使用[restore<sup>9+</sup>](#restore9-1)替代。
+restore(callback: AsyncCallback&lt;boolean&gt;): void

 重新启动暂停的下载任务，异步方法，使用callback形式返回结果。

@@ -1495,13 +1468,13 @@ resume(callback: AsyncCallback&lt;void&gt;): void

  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;void&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |

 **示例：**
-  
+
  ```js
  let downloadTask;
-  downloadTask.resume((err, result)=>{
+  downloadTask.restore((err, result)=>{
      if (err) {
          console.error('Failed to resume the download task. Cause:' + err);
          return;
@@ -1515,27 +1488,30 @@ resume(callback: AsyncCallback&lt;void&gt;): void
  ```


-### delete<sup>9+</sup>

-delete(): Promise&lt;boolean&gt;
+### remove<sup>(deprecated)</sup>
+
+remove(): Promise&lt;boolean&gt;

 移除下载的任务，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 9开始不再维护，建议使用[delete<sup>9+</sup>](#delete9-2)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;boolean&gt; | 移除任务是否成功。 |
+  | Promise&lt;boolean&gt; | 移除任务是否成功。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.delete().then((result) => {
+  downloadTask.remove().then((result) => {
      if (result) {
          console.info('Download task removed.');
      } else {
@@ -1547,27 +1523,29 @@ delete(): Promise&lt;boolean&gt;
  ```


-### delete<sup>9+</sup>
+### remove<sup>(deprecated)</sup>

-delete(callback: AsyncCallback&lt;boolean&gt;): void
+remove(callback: AsyncCallback&lt;boolean&gt;): void

 移除下载的任务，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 9开始不再维护，建议使用[delete<sup>9+</sup>](#delete9-3)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |
+  | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.delete((err, result)=>{
+  downloadTask.remove((err, result)=>{
      if(err) {
          console.error('Failed to remove the download task.');
          return;
@@ -1581,27 +1559,29 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void
  ```


-### getTaskInfo<sup>9+</sup>
+### query<sup>(deprecated)</sup>

-getTaskInfo(): Promise&lt;DownloadInfo&gt;
+query(): Promise&lt;DownloadInfo&gt;

 查询下载任务，异步方法，使用promise形式返回DownloadInfo里的信息。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **返回值：**

-| 类型 | 说明 |
-| -------- | -------- |
-| Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |
+  | 类型 | 说明 |
+  | -------- | -------- |
+  | Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.getTaskInfo().then((downloadInfo) => {    
+  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)
@@ -1609,27 +1589,29 @@ getTaskInfo(): Promise&lt;DownloadInfo&gt;
  ```


-### getTaskInfo<sup>9+</sup>
+### query<sup>(deprecated)</sup>

-getTaskInfo(callback: AsyncCallback&lt;DownloadInfo&gt;): void
+query(callback: AsyncCallback&lt;DownloadInfo&gt;): void

 查询下载的任务，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9-1)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |
+  | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.getTaskInfo((err, downloadInfo)=>{
+  downloadTask.query((err, downloadInfo)=>{
      if(err) {
          console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
      } else {
@@ -1639,27 +1621,29 @@ getTaskInfo(callback: AsyncCallback&lt;DownloadInfo&gt;): void
  ```


-### getTaskMimeType<sup>9+</sup>
+### queryMimeType<sup>(deprecated)</sup>

-getTaskMimeType(): Promise&lt;string&gt;
+queryMimeType(): Promise&lt;string&gt;

 查询下载的任务的 MimeType，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;string&gt; | 查询下载任务的MimeType。 |
+  | Promise&lt;string&gt; | 查询下载任务的MimeType。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.getTaskMimeType().then((data) => {    
+  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))
@@ -1667,27 +1651,29 @@ getTaskMimeType(): Promise&lt;string&gt;
  ```


-### getTaskMimeType<sup>9+</sup>
+### queryMimeType<sup>(deprecated)</sup>

-getTaskMimeType(callback: AsyncCallback&lt;string&gt;): void;
+queryMimeType(callback: AsyncCallback&lt;string&gt;): void;

 查询下载的任务的 MimeType，异步方法，使用callback形式返回结果。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9-1)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |
+  | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.getTaskMimeType((err, data)=>{
+  downloadTask.queryMimeType((err, data)=>{
      if(err) {
          console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
      } else {
@@ -1697,27 +1683,29 @@ getTaskMimeType(callback: AsyncCallback&lt;string&gt;): void;
  ```


-### suspend<sup>9+</sup>
+### pause<sup>(deprecated)</sup>

-suspend(): Promise&lt;boolean&gt;
+pause(): Promise&lt;void&gt;

 暂停下载任务，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[suspend<sup>9+</sup>](#suspend9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;boolean&gt; | 暂停下载任务是否成功。 |
+  | Promise&lt;void&gt; | 暂停下载任务是否成功。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.suspend().then((result) => {    
+  downloadTask.pause().then((result) => {    
      if (result) {
           console.info('Download task paused. ');
      } else {
@@ -1729,9 +1717,11 @@ suspend(): Promise&lt;boolean&gt;
  ```


-### suspend<sup>9+</sup>
+### pause<sup>(deprecated)</sup>

-suspend(callback: AsyncCallback&lt;boolean&gt;): void
+pause(callback: AsyncCallback&lt;void&gt;): void
+
+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[suspend<sup>9+</sup>](#suspend9-1)替代。

 暂停下载任务，异步方法，使用callback形式返回结果。

@@ -1741,15 +1731,15 @@ suspend(callback: AsyncCallback&lt;boolean&gt;): void

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 |
+  | callback | AsyncCallback&lt;void&gt; | 是 | 暂停下载任务的回调函数。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.suspend((err, result)=>{
+  downloadTask.pause((err, result)=>{
      if(err) {
          console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
          return;
@@ -1763,27 +1753,29 @@ suspend(callback: AsyncCallback&lt;boolean&gt;): void
  ```


-### restore<sup>9+</sup>
+### resume<sup>(deprecated)</sup>

-restore(): Promise&lt;boolean&gt;
+resume(): Promise&lt;void&gt;

 重新启动暂停的下载任务，异步方法，使用promise形式返回结果。

+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[restore<sup>9+</sup>](#restore9)替代。
+
 **需要权限**：ohos.permission.INTERNET

 **系统能力**: SystemCapability.MiscServices.Download

 **返回值：**

-| 类型 | 说明 |
+  | 类型 | 说明 |
  | -------- | -------- |
-| Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 |
+  | Promise&lt;void&gt; | 重新启动暂停的下载任务是否成功。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.restore().then((result) => {
+  downloadTask.resume().then((result) => {
      if (result) {
          console.info('Download task resumed.')
      } else {
@@ -1796,9 +1788,11 @@ restore(): Promise&lt;boolean&gt;
  ```


-### restore<sup>9+</sup>
+### resume<sup>(deprecated)</sup>

-restore(callback: AsyncCallback&lt;boolean&gt;): void
+resume(callback: AsyncCallback&lt;void&gt;): void
+
+>  **说明：** 从API Version 7开始支持，从API Version 9开始不再维护，建议使用[restore<sup>9+</sup>](#restore9-1)替代。

 重新启动暂停的下载任务，异步方法，使用callback形式返回结果。

@@ -1808,15 +1802,15 @@ restore(callback: AsyncCallback&lt;boolean&gt;): void

 **参数：**

-| 参数名 | 类型 | 必填 | 说明 |
+  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
-| callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
+  | callback | AsyncCallback&lt;void&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |

 **示例：**

  ```js
  let downloadTask;
-  downloadTask.restore((err, result)=>{
+  downloadTask.resume((err, result)=>{
      if (err) {
          console.error('Failed to resume the download task. Cause:' + err);
          return;