提交 624ebd36 编写于 作者: A anyueling

API参考内容优化改进

Signed-off-by: Nanyueling <anyueling@huawei.com>
上级 e2b63e42
...@@ -68,16 +68,12 @@ var config = { ...@@ -68,16 +68,12 @@ var config = {
| SESSION_SUCCESSFUL<sup>7+</sup> | number | 是 | 否 | 下载会话已完成。 | | 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形式返回结果。 上传,异步方法,使用promise形式返回结果。
此接口仅可在FA模型下使用
> **说明:** 从API Version 9开始废弃,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
...@@ -86,16 +82,25 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt; ...@@ -86,16 +82,25 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 | | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |
**错误码:**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
let uploadConfig = { let uploadConfig = {
...@@ -105,24 +110,20 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt; ...@@ -105,24 +110,20 @@ upload(config: UploadConfig): Promise&lt;UploadTask&gt;
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.upload(uploadConfig).then((data) => { request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => {
uploadTask = data; uploadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(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形式返回结果。 上传,异步方法,使用callback形式返回结果。
此接口仅可在FA模型下使用
> **说明:** 从API Version 9开始废弃,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
...@@ -131,11 +132,19 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void ...@@ -131,11 +132,19 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
| callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 | | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 |
**错误码:**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
let uploadConfig = { let uploadConfig = {
...@@ -145,7 +154,7 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void ...@@ -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" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.upload(uploadConfig, (err, data) => { request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(err)); console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
return; return;
...@@ -153,13 +162,16 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void ...@@ -153,13 +162,16 @@ upload(config: UploadConfig, callback: AsyncCallback&lt;UploadTask&gt;): void
uploadTask = data; 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形式返回结果。 上传,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。 **模型约束**:此接口仅可在FA模型下使用
> **说明:** 从API Version 9开始不再维护,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
...@@ -169,9 +181,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt; ...@@ -169,9 +181,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
**返回值:** **返回值:**
...@@ -180,7 +190,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt; ...@@ -180,7 +190,7 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
| Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 | | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
let uploadConfig = { let uploadConfig = {
...@@ -190,21 +200,23 @@ upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt; ...@@ -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" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.upload(globalThis.abilityContext, uploadConfig).then((data) => { request.upload(uploadConfig).then((data) => {
uploadTask = data; uploadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(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形式返回结果。 上传,异步方法,使用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 **需要权限**:ohos.permission.INTERNET
...@@ -214,12 +226,11 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up ...@@ -214,12 +226,11 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
| callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 | | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
let uploadConfig = { let uploadConfig = {
...@@ -229,7 +240,7 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up ...@@ -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" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.upload(globalThis.abilityContext, uploadConfig, (err, data) => { request.upload(uploadConfig, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(err)); console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
return; return;
...@@ -238,37 +249,31 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up ...@@ -238,37 +249,31 @@ upload(context: BaseContext, config: UploadConfig, callback: AsyncCallback&lt;Up
}); });
``` ```
## request.upload<sup>(deprecated)</sup>
## request.uploadFile<sup>9+</sup> upload(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;UploadTask&gt;
上传,异步方法,使用promise形式返回结果。 上传,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始支持,从API Version 9开始不再维护,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 | | context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 | | Promise&lt;[UploadTask](#uploadtask)&gt; | 返回上传任务。 |
**错误码:**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例:** **示例:**
...@@ -281,7 +286,7 @@ uploadFile(context: BaseContext, config: UploadConfig): Promise&lt;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" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.uploadFile(globalThis.abilityContext, uploadConfig).then((data) => { request.upload(globalThis.abilityContext, uploadConfig).then((data) => {
uploadTask = data; uploadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(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 ...@@ -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形式返回结果。 上传,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始支持,从API Version 9开始不再维护,建议使用[request.uploadFile<sup>9+</sup>](#requestuploadfile9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 | | context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 | | config | [UploadConfig](#uploadconfig) | 是 | 上传的配置信息。 |
| callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 | | callback | AsyncCallback&lt;[UploadTask](#uploadtask)&gt; | 是 | 回调函数,异步返回UploadTask对象。 |
**错误码:**
以下错误码的详细介绍请参见[上传下载错误码](../errorcodes/errorcode-request.md)
| 错误码ID | 错误信息 |
| -------- | -------- |
| 13400002 | Bad file path. |
**示例:** **示例:**
...@@ -325,7 +325,7 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l ...@@ -325,7 +325,7 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l
files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }], files: [{ filename: "test", name: "test", uri: "internal://cache/test.jpg", type: "jpg" }],
data: [{ name: "name123", value: "123" }], data: [{ name: "name123", value: "123" }],
}; };
request.uploadFile(globalThis.abilityContext, uploadConfig, (err, data) => { request.upload(globalThis.abilityContext, uploadConfig, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the upload. Cause: ' + JSON.stringify(err)); console.error('Failed to request the upload. Cause: ' + JSON.stringify(err));
return; return;
...@@ -334,7 +334,6 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l ...@@ -334,7 +334,6 @@ uploadFile(context: BaseContext, config: UploadConfig, callback: AsyncCallback&l
}); });
``` ```
## UploadTask ## UploadTask
上传任务,使用下列方法前,需要先获取UploadTask对象。 上传任务,使用下列方法前,需要先获取UploadTask对象。
...@@ -365,7 +364,7 @@ on(type: 'progress', callback:(uploadedSize: number, totalSize: number) =&gt; vo ...@@ -365,7 +364,7 @@ on(type: 'progress', callback:(uploadedSize: number, totalSize: number) =&gt; vo
| totalSize | number | 是 | 上传文件的总大小,单位为KB。 | | totalSize | number | 是 | 上传文件的总大小,单位为KB。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.on('progress', function callback(uploadedSize, totalSize) { uploadTask.on('progress', function callback(uploadedSize, totalSize) {
...@@ -399,7 +398,7 @@ on(type: 'headerReceive', callback: (header: object) =&gt; void): void ...@@ -399,7 +398,7 @@ on(type: 'headerReceive', callback: (header: object) =&gt; void): void
| header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 | | header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.on('headerReceive', function callback(headers){ uploadTask.on('headerReceive', function callback(headers){
...@@ -433,7 +432,7 @@ on(type: 'headerReceive', callback: (header: object) =&gt; void): void ...@@ -433,7 +432,7 @@ on(type: 'headerReceive', callback: (header: object) =&gt; void): void
| taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 | | taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.on('complete', function callback(taskStates) { uploadTask.on('complete', function callback(taskStates) {
...@@ -477,7 +476,7 @@ off(type: 'progress', callback?: (uploadedSize: number, totalSize: number) =&g ...@@ -477,7 +476,7 @@ off(type: 'progress', callback?: (uploadedSize: number, totalSize: number) =&g
| totalSize | number | 是 | 上传文件的总大小,单位为KB。 | | totalSize | number | 是 | 上传文件的总大小,单位为KB。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.off('progress', function callback(uploadedSize, totalSize) { uploadTask.off('progress', function callback(uploadedSize, totalSize) {
...@@ -511,7 +510,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void ...@@ -511,7 +510,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
| header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 | | header | object | 是 | HTTP&nbsp;Response&nbsp;Header。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.off('headerReceive', function callback(headers) { uploadTask.off('headerReceive', function callback(headers) {
...@@ -544,7 +543,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void ...@@ -544,7 +543,7 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
| taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 | | taskstates | Array&lt;[TaskState](#taskstate9)&gt; | 是 | 上传任务返回结果 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.off('complete', function callback(taskStates) { uploadTask.off('complete', function callback(taskStates) {
...@@ -562,15 +561,11 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void ...@@ -562,15 +561,11 @@ off(type: 'headerReceive', callback?: (header: object) =&gt; void): void
); );
``` ```
### delete<sup>9+</sup>
### remove delete(): Promise&lt;boolean&gt;
remove(): Promise&lt;boolean&gt;
移除上传的任务,异步方法,使用promise形式返回结果。 移除上传的任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[delete<sup>9+</sup>](#delete9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
...@@ -582,10 +577,10 @@ remove(): Promise&lt;boolean&gt; ...@@ -582,10 +577,10 @@ remove(): Promise&lt;boolean&gt;
| Promise&lt;boolean&gt; | 移除任务是否成功。true:成功,false:不成功。 | | Promise&lt;boolean&gt; | 移除任务是否成功。true:成功,false:不成功。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.remove().then((result) => { uploadTask.delete().then((result) => {
if (result) { if (result) {
console.info('Upload task removed successfully. '); console.info('Upload task removed successfully. ');
} else { } else {
...@@ -597,14 +592,12 @@ remove(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 移除上传的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[delete<sup>9+</sup>](#delete9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
...@@ -616,10 +609,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -616,10 +609,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.remove((err, result) => { uploadTask.delete((err, result) => {
if (err) { if (err) {
console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err)); console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
return; return;
...@@ -633,27 +626,29 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -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形式返回结果。 移除上传的任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始不再维护,建议使用[delete<sup>9+</sup>](#delete9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 移除任务是否成功。true:成功,false:不成功。 | | Promise&lt;boolean&gt; | 移除任务是否成功。true:成功,false:不成功。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.delete().then((result) => { uploadTask.remove().then((result) => {
if (result) { if (result) {
console.info('Upload task removed successfully. '); console.info('Upload task removed successfully. ');
} else { } else {
...@@ -665,27 +660,29 @@ delete(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 移除上传的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始不再维护,建议使用[delete<sup>9+</sup>](#delete9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Upload **系统能力**: SystemCapability.MiscServices.Upload
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务的回调函数。 |
**示例:** **示例:**
```js ```js
let uploadTask; let uploadTask;
uploadTask.delete((err, result) => { uploadTask.remove((err, result) => {
if (err) { if (err) {
console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err)); console.error('Failed to remove the upload task. Cause: ' + JSON.stringify(err));
return; return;
...@@ -698,7 +695,6 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -698,7 +695,6 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void
}); });
``` ```
## UploadConfig ## UploadConfig
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
...@@ -750,17 +746,12 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -750,17 +746,12 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void
| name | string | 是 | 表示表单元素的名称。 | | name | string | 是 | 表示表单元素的名称。 |
| value | string | 是 | 表示表单元素的值。 | | value | string | 是 | 表示表单元素的值。 |
## request.downloadFile<sup>9+</sup>
## request.download downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
下载,异步方法,使用promise形式返回结果。 下载,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
此接口仅可在FA模型下使用
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -769,6 +760,7 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt; ...@@ -769,6 +760,7 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
**返回值:** **返回值:**
...@@ -777,11 +769,20 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt; ...@@ -777,11 +769,20 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt;
| -------- | -------- | | -------- | -------- |
| Promise&lt;[DownloadTask](#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 ```js
let downloadTask; let downloadTask;
request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => { request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => {
downloadTask = data; downloadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the download. Cause: ' + JSON.stringify(err)); console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
...@@ -789,16 +790,12 @@ download(config: DownloadConfig): Promise&lt;DownloadTask&gt; ...@@ -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形式返回结果。 下载,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
此接口仅可在FA模型下使用
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -807,14 +804,24 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v ...@@ -807,14 +804,24 @@ download(config: DownloadConfig, callback: AsyncCallback&lt;DownloadTask&gt;): v
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
| callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 | | 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 ```js
let downloadTask; let downloadTask;
request.download({ url: 'https://xxxx/xxxxx.hap', request.downloadFile(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap',
filePath: 'xxx/xxxxx.hap'}, (err, data) => { filePath: 'xxx/xxxxx.hap'}, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the download. Cause: ' + JSON.stringify(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 ...@@ -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形式返回结果。 下载,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。 > **说明:** 从API Version 9开始不再维护,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
**模型约束**:此接口仅可在FA模型下使用
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
...@@ -840,7 +849,6 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask& ...@@ -840,7 +849,6 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
**返回值:** **返回值:**
...@@ -850,10 +858,10 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask& ...@@ -850,10 +858,10 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&
| Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 | | Promise&lt;[DownloadTask](#downloadtask)&gt; | 返回下载任务。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
request.download(globalThis.abilityContext, { url: 'https://xxxx/xxxx.hap' }).then((data) => { request.download({ url: 'https://xxxx/xxxx.hap' }).then((data) => {
downloadTask = data; downloadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the download. Cause: ' + JSON.stringify(err)); console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
...@@ -861,13 +869,15 @@ download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask& ...@@ -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形式返回结果。 下载,异步方法,使用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 **需要权限**:ohos.permission.INTERNET
...@@ -877,15 +887,14 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l ...@@ -877,15 +887,14 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
| callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 | | callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
request.download(globalThis.abilityContext, { url: 'https://xxxx/xxxxx.hap', request.download({ url: 'https://xxxx/xxxxx.hap',
filePath: 'xxx/xxxxx.hap'}, (err, data) => { filePath: 'xxx/xxxxx.hap'}, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the download. Cause: ' + JSON.stringify(err)); console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
...@@ -895,44 +904,36 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l ...@@ -895,44 +904,36 @@ download(context: BaseContext, config: DownloadConfig, callback: AsyncCallback&l
}); });
``` ```
## request.download<sup>(deprecated)</sup>
## request.downloadFile<sup>9+</sup> download(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadTask&gt;
下载,异步方法,使用promise形式返回结果。 下载,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始支持,从API Version 9开始不再维护,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 | | context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;[DownloadTask](#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 ```js
let downloadTask; 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; downloadTask = data;
}).catch((err) => { }).catch((err) => {
console.error('Failed to request the download. Cause: ' + JSON.stringify(err)); console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
...@@ -940,38 +941,31 @@ downloadFile(context: BaseContext, config: DownloadConfig): Promise&lt;DownloadT ...@@ -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形式返回结果。 下载,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始支持,从API Version 9开始不再维护,建议使用[request.downloadFile<sup>9+</sup>](#requestdownloadfile9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| context | BaseContext | 是 | 基于应用程序的上下文。 | | context | BaseContext | 是 | 基于应用程序的上下文。 |
| config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 | | config | [DownloadConfig](#downloadconfig) | 是 | 下载的配置信息。 |
| callback | AsyncCallback&lt;[DownloadTask](#downloadtask)&gt; | 是 | 下载接口的回调函数。 | | 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 ```js
let downloadTask; 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) => { filePath: 'xxx/xxxxx.hap'}, (err, data) => {
if (err) { if (err) {
console.error('Failed to request the download. Cause: ' + JSON.stringify(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 ...@@ -1012,7 +1006,7 @@ on(type: 'progress', callback:(receivedSize: number, totalSize: number) =&gt; vo
| totalSize | number | 是 | 下载文件的总大小,单位为KB。 | | totalSize | number | 是 | 下载文件的总大小,单位为KB。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.on('progress', function download_callback(receivedSize, totalSize) { downloadTask.on('progress', function download_callback(receivedSize, totalSize) {
...@@ -1047,7 +1041,7 @@ off(type: 'progress', callback?: (receivedSize: number, totalSize: number) =&gt; ...@@ -1047,7 +1041,7 @@ off(type: 'progress', callback?: (receivedSize: number, totalSize: number) =&gt;
| totalSize | number | 是 | 下载文件的总大小。 | | totalSize | number | 是 | 下载文件的总大小。 |
**示例:** **示例:**
```js ```js
downloadTask .off('progress', function download_callback(receivedSize, totalSize) { downloadTask .off('progress', function download_callback(receivedSize, totalSize) {
console.info("download receivedSize:" + receivedSize + " totalSize:" + totalSize); console.info("download receivedSize:" + receivedSize + " totalSize:" + totalSize);
...@@ -1074,7 +1068,7 @@ on(type: 'complete'|'pause'|'remove', callback:() =&gt; void): void ...@@ -1074,7 +1068,7 @@ on(type: 'complete'|'pause'|'remove', callback:() =&gt; void): void
| callback | function | 是 | 回调函数。 | | callback | function | 是 | 回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.on('complete', function callback() { downloadTask.on('complete', function callback() {
...@@ -1102,7 +1096,7 @@ off(type: 'complete'|'pause'|'remove', callback?:() =&gt; void): void ...@@ -1102,7 +1096,7 @@ off(type: 'complete'|'pause'|'remove', callback?:() =&gt; void): void
| callback | function | 否 | 回调函数。 | | callback | function | 否 | 回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.off('complete', function callback() { downloadTask.off('complete', function callback() {
...@@ -1136,7 +1130,7 @@ on(type: 'fail', callback: (err: number) =&gt; void): void ...@@ -1136,7 +1130,7 @@ on(type: 'fail', callback: (err: number) =&gt; void): void
| err | number | 是 | 下载失败的错误码,错误原因见[ERROR.*](#常量)。 | | err | number | 是 | 下载失败的错误码,错误原因见[ERROR.*](#常量)。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.on('fail', function callBack(err) { downloadTask.on('fail', function callBack(err) {
...@@ -1170,7 +1164,7 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void ...@@ -1170,7 +1164,7 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void
| err | number | 是 | 下载失败的错误码。错误原因见[ERROR_*](#常量)。 | | err | number | 是 | 下载失败的错误码。错误原因见[ERROR_*](#常量)。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.off('fail', function callBack(err) { downloadTask.off('fail', function callBack(err) {
...@@ -1179,15 +1173,12 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void ...@@ -1179,15 +1173,12 @@ off(type: 'fail', callback?: (err: number) =&gt; void): void
); );
``` ```
### delete<sup>9+</sup>
### remove delete(): Promise&lt;boolean&gt;
remove(): Promise&lt;boolean&gt;
移除下载的任务,异步方法,使用promise形式返回结果。 移除下载的任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[delete<sup>9+</sup>](#delete9-2)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1199,10 +1190,10 @@ remove(): Promise&lt;boolean&gt; ...@@ -1199,10 +1190,10 @@ remove(): Promise&lt;boolean&gt;
| Promise&lt;boolean&gt; | 移除任务是否成功。 | | Promise&lt;boolean&gt; | 移除任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.remove().then((result) => { downloadTask.delete().then((result) => {
if (result) { if (result) {
console.info('Download task removed.'); console.info('Download task removed.');
} else { } else {
...@@ -1214,14 +1205,12 @@ remove(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 移除下载的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[delete<sup>9+</sup>](#delete9-3)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1233,10 +1222,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -1233,10 +1222,10 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.remove((err, result)=>{ downloadTask.delete((err, result)=>{
if(err) { if(err) {
console.error('Failed to remove the download task.'); console.error('Failed to remove the download task.');
return; return;
...@@ -1250,14 +1239,12 @@ remove(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -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里的信息。 查询下载任务,异步方法,使用promise形式返回DownloadInfo里的信息。
> **说明:** 从API Version 9开始废弃,建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1269,10 +1256,10 @@ query(): Promise&lt;DownloadInfo&gt; ...@@ -1269,10 +1256,10 @@ query(): Promise&lt;DownloadInfo&gt;
| Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 | | Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.query().then((downloadInfo) => { downloadTask.getTaskInfo().then((downloadInfo) => {
console.info('Download task queried. Data:' + JSON.stringify(downloadInfo)) console.info('Download task queried. Data:' + JSON.stringify(downloadInfo))
}) .catch((err) => { }) .catch((err) => {
console.error('Failed to query the download task. Cause:' + err) console.error('Failed to query the download task. Cause:' + err)
...@@ -1280,14 +1267,12 @@ query(): Promise&lt;DownloadInfo&gt; ...@@ -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形式返回结果。 查询下载的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1299,10 +1284,10 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void ...@@ -1299,10 +1284,10 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void
| callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 | | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.query((err, downloadInfo)=>{ downloadTask.getTaskInfo((err, downloadInfo)=>{
if(err) { if(err) {
console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err)); console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
} else { } else {
...@@ -1312,14 +1297,12 @@ query(callback: AsyncCallback&lt;DownloadInfo&gt;): void ...@@ -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形式返回结果。 查询下载的任务的 MimeType,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1331,10 +1314,10 @@ queryMimeType(): Promise&lt;string&gt; ...@@ -1331,10 +1314,10 @@ queryMimeType(): Promise&lt;string&gt;
| Promise&lt;string&gt; | 查询下载任务的MimeType。 | | Promise&lt;string&gt; | 查询下载任务的MimeType。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.queryMimeType().then((data) => { downloadTask.getTaskMimeType().then((data) => {
console.info('Download task queried. Data:' + JSON.stringify(data)); console.info('Download task queried. Data:' + JSON.stringify(data));
}).catch((err) => { }).catch((err) => {
console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err)) console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err))
...@@ -1342,14 +1325,12 @@ queryMimeType(): Promise&lt;string&gt; ...@@ -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形式返回结果。 查询下载的任务的 MimeType,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1361,10 +1342,10 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void; ...@@ -1361,10 +1342,10 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void;
| callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 | | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.queryMimeType((err, data)=>{ downloadTask.getTaskMimeType((err, data)=>{
if(err) { if(err) {
console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err)); console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
} else { } else {
...@@ -1374,14 +1355,12 @@ queryMimeType(callback: AsyncCallback&lt;string&gt;): void; ...@@ -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形式返回结果。 暂停下载任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[suspend<sup>9+</sup>](#suspend9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1390,13 +1369,13 @@ pause(): Promise&lt;void&gt; ...@@ -1390,13 +1369,13 @@ pause(): Promise&lt;void&gt;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 暂停下载任务是否成功。 | | Promise&lt;boolean&gt; | 暂停下载任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.pause().then((result) => { downloadTask.suspend().then((result) => {
if (result) { if (result) {
console.info('Download task paused. '); console.info('Download task paused. ');
} else { } else {
...@@ -1408,11 +1387,9 @@ pause(): Promise&lt;void&gt; ...@@ -1408,11 +1387,9 @@ pause(): Promise&lt;void&gt;
``` ```
### pause<sup>7+</sup> ### suspend<sup>9+</sup>
pause(callback: AsyncCallback&lt;void&gt;): void
> **说明:** 从API Version 9开始废弃,建议使用[suspend<sup>9+</sup>](#suspend9-1)替代。 suspend(callback: AsyncCallback&lt;boolean&gt;): void
暂停下载任务,异步方法,使用callback形式返回结果。 暂停下载任务,异步方法,使用callback形式返回结果。
...@@ -1424,13 +1401,13 @@ pause(callback: AsyncCallback&lt;void&gt;): void ...@@ -1424,13 +1401,13 @@ pause(callback: AsyncCallback&lt;void&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 暂停下载任务的回调函数。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.pause((err, result)=>{ downloadTask.suspend((err, result)=>{
if(err) { if(err) {
console.error('Failed to pause the download task. Cause:' + JSON.stringify(err)); console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
return; return;
...@@ -1444,14 +1421,12 @@ pause(callback: AsyncCallback&lt;void&gt;): void ...@@ -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形式返回结果。 重新启动暂停的下载任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始废弃,建议使用[restore<sup>9+</sup>](#restore9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
...@@ -1460,13 +1435,13 @@ resume(): Promise&lt;void&gt; ...@@ -1460,13 +1435,13 @@ resume(): Promise&lt;void&gt;
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;void&gt; | 重新启动暂停的下载任务是否成功。 | | Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.resume().then((result) => { downloadTask.restore().then((result) => {
if (result) { if (result) {
console.info('Download task resumed.') console.info('Download task resumed.')
} else { } else {
...@@ -1479,11 +1454,9 @@ resume(): Promise&lt;void&gt; ...@@ -1479,11 +1454,9 @@ resume(): Promise&lt;void&gt;
``` ```
### resume<sup>7+</sup> ### restore<sup>9+</sup>
resume(callback: AsyncCallback&lt;void&gt;): void
> **说明:** 从API Version 9开始废弃,建议使用[restore<sup>9+</sup>](#restore9-1)替代。 restore(callback: AsyncCallback&lt;boolean&gt;): void
重新启动暂停的下载任务,异步方法,使用callback形式返回结果。 重新启动暂停的下载任务,异步方法,使用callback形式返回结果。
...@@ -1495,13 +1468,13 @@ resume(callback: AsyncCallback&lt;void&gt;): void ...@@ -1495,13 +1468,13 @@ resume(callback: AsyncCallback&lt;void&gt;): void
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;void&gt; | 是 | 重新启动暂停的下载任务的回调函数。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.resume((err, result)=>{ downloadTask.restore((err, result)=>{
if (err) { if (err) {
console.error('Failed to resume the download task. Cause:' + err); console.error('Failed to resume the download task. Cause:' + err);
return; return;
...@@ -1515,27 +1488,30 @@ resume(callback: AsyncCallback&lt;void&gt;): void ...@@ -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形式返回结果。 移除下载的任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 9开始不再维护,建议使用[delete<sup>9+</sup>](#delete9-2)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 移除任务是否成功。 | | Promise&lt;boolean&gt; | 移除任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.delete().then((result) => { downloadTask.remove().then((result) => {
if (result) { if (result) {
console.info('Download task removed.'); console.info('Download task removed.');
} else { } else {
...@@ -1547,27 +1523,29 @@ delete(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 移除下载的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 9开始不再维护,建议使用[delete<sup>9+</sup>](#delete9-3)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 移除任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.delete((err, result)=>{ downloadTask.remove((err, result)=>{
if(err) { if(err) {
console.error('Failed to remove the download task.'); console.error('Failed to remove the download task.');
return; return;
...@@ -1581,27 +1559,29 @@ delete(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -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里的信息。 查询下载任务,异步方法,使用promise形式返回DownloadInfo里的信息。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 | | Promise&lt;[DownloadInfo](#downloadinfo7)&gt; | 查询下载任务信息。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.getTaskInfo().then((downloadInfo) => { downloadTask.query().then((downloadInfo) => {
console.info('Download task queried. Data:' + JSON.stringify(downloadInfo)) console.info('Download task queried. Data:' + JSON.stringify(downloadInfo))
}) .catch((err) => { }) .catch((err) => {
console.error('Failed to query the download task. Cause:' + err) console.error('Failed to query the download task. Cause:' + err)
...@@ -1609,27 +1589,29 @@ getTaskInfo(): Promise&lt;DownloadInfo&gt; ...@@ -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形式返回结果。 查询下载的任务,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[getTaskInfo<sup>9+</sup>](#gettaskinfo9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 | | callback | AsyncCallback&lt;[DownloadInfo](#downloadinfo7)&gt; | 是 | 查询下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.getTaskInfo((err, downloadInfo)=>{ downloadTask.query((err, downloadInfo)=>{
if(err) { if(err) {
console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err)); console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
} else { } else {
...@@ -1639,27 +1621,29 @@ getTaskInfo(callback: AsyncCallback&lt;DownloadInfo&gt;): void ...@@ -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形式返回结果。 查询下载的任务的 MimeType,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;string&gt; | 查询下载任务的MimeType。 | | Promise&lt;string&gt; | 查询下载任务的MimeType。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.getTaskMimeType().then((data) => { downloadTask.queryMimeType().then((data) => {
console.info('Download task queried. Data:' + JSON.stringify(data)); console.info('Download task queried. Data:' + JSON.stringify(data));
}).catch((err) => { }).catch((err) => {
console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err)) console.error('Failed to query the download MimeType. Cause:' + JSON.stringify(err))
...@@ -1667,27 +1651,29 @@ getTaskMimeType(): Promise&lt;string&gt; ...@@ -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形式返回结果。 查询下载的任务的 MimeType,异步方法,使用callback形式返回结果。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[getTaskMimeType<sup>9+</sup>](#gettaskmimetype9-1)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 | | callback | AsyncCallback&lt;string&gt; | 是 | 查询下载任务的MimeType的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.getTaskMimeType((err, data)=>{ downloadTask.queryMimeType((err, data)=>{
if(err) { if(err) {
console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err)); console.error('Failed to query the download mimeType. Cause:' + JSON.stringify(err));
} else { } else {
...@@ -1697,27 +1683,29 @@ getTaskMimeType(callback: AsyncCallback&lt;string&gt;): void; ...@@ -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形式返回结果。 暂停下载任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[suspend<sup>9+</sup>](#suspend9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 暂停下载任务是否成功。 | | Promise&lt;void&gt; | 暂停下载任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.suspend().then((result) => { downloadTask.pause().then((result) => {
if (result) { if (result) {
console.info('Download task paused. '); console.info('Download task paused. ');
} else { } else {
...@@ -1729,9 +1717,11 @@ suspend(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 暂停下载任务,异步方法,使用callback形式返回结果。
...@@ -1741,15 +1731,15 @@ suspend(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -1741,15 +1731,15 @@ suspend(callback: AsyncCallback&lt;boolean&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 暂停下载任务的回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 暂停下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.suspend((err, result)=>{ downloadTask.pause((err, result)=>{
if(err) { if(err) {
console.error('Failed to pause the download task. Cause:' + JSON.stringify(err)); console.error('Failed to pause the download task. Cause:' + JSON.stringify(err));
return; return;
...@@ -1763,27 +1753,29 @@ suspend(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -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形式返回结果。 重新启动暂停的下载任务,异步方法,使用promise形式返回结果。
> **说明:** 从API Version 7开始支持,从API Version 9开始不再维护,建议使用[restore<sup>9+</sup>](#restore9)替代。
**需要权限**:ohos.permission.INTERNET **需要权限**:ohos.permission.INTERNET
**系统能力**: SystemCapability.MiscServices.Download **系统能力**: SystemCapability.MiscServices.Download
**返回值:** **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | 重新启动暂停的下载任务是否成功。 | | Promise&lt;void&gt; | 重新启动暂停的下载任务是否成功。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.restore().then((result) => { downloadTask.resume().then((result) => {
if (result) { if (result) {
console.info('Download task resumed.') console.info('Download task resumed.')
} else { } else {
...@@ -1796,9 +1788,11 @@ restore(): Promise&lt;boolean&gt; ...@@ -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形式返回结果。 重新启动暂停的下载任务,异步方法,使用callback形式返回结果。
...@@ -1808,15 +1802,15 @@ restore(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -1808,15 +1802,15 @@ restore(callback: AsyncCallback&lt;boolean&gt;): void
**参数:** **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 重新启动暂停的下载任务的回调函数。 | | callback | AsyncCallback&lt;void&gt; | 是 | 重新启动暂停的下载任务的回调函数。 |
**示例:** **示例:**
```js ```js
let downloadTask; let downloadTask;
downloadTask.restore((err, result)=>{ downloadTask.resume((err, result)=>{
if (err) { if (err) {
console.error('Failed to resume the download task. Cause:' + err); console.error('Failed to resume the download task. Cause:' + err);
return; return;
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册