diff --git a/zh-cn/application-dev/reference/apis/js-apis-request.md b/zh-cn/application-dev/reference/apis/js-apis-request.md index 2e8f3bed49b7b5ab43621d61e1c797bf1629874b..9b3e450dbf6baba543330efe7a014542d67e06e2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-request.md +++ b/zh-cn/application-dev/reference/apis/js-apis-request.md @@ -299,6 +299,48 @@ on(type: 'headerReceive', callback: (header: object) => void): void ``` +### on('complete' | 'fail')9+ + + on(type:'complete' | 'fail', callback: Callback<Array<TaskState>>): void; + +开启上传任务监听,异步方法,使用callback形式返回结果。 + +**需要权限**:ohos.permission.INTERNET + +**系统能力**: SystemCapability.MiscServices.Upload + +**参数:** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 订阅的事件类型,取值为'complete',表示上传任务完成;取值为'fail',表示上传任务失败。| + | callback | function | 是 | 上传任务完成或失败的回调函数。 | + + 回调函数的参数 + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| taskstates | Array<[TaskState](#taskstate9)> | 是 | 上传任务返回结果 | + +**示例:** + + ```js + uploadTask.on('complete', function callback(taskStates) { + for (let i = 0; i < taskStates.length; i++ ) { + console.info("upOnComplete taskState:" + JSON.stringify(taskStates[i])); + } + } + ); + + uploadTask.on('fail', function callback(taskStates) { + for (let i = 0; i < taskStates.length; i++ ) { + console.info("upOnFail taskState:" + JSON.stringify(taskStates[i])); + } + } + ); + ``` + + ### off('progress') off(type: 'progress', callback?: (uploadedSize: number, totalSize: number) => void): void @@ -365,6 +407,47 @@ off(type: 'headerReceive', callback?: (header: object) => void): void ); ``` +### off('complete' | 'fail')9+ + + off(type:'complete' | 'fail', callback?: Callback<Array<TaskState>>): void; + +关闭上传任务监听,异步方法,使用callback形式返回结果。 + +**需要权限**:ohos.permission.INTERNET + +**系统能力**: SystemCapability.MiscServices.Upload + +**参数:** + + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 订阅的事件类型,取值为'complete',表示上传任务完成;取值为'fail',表示上传任务失败。| + | callback | function | 否 | 上传任务完成或失败的回调函数。 | + + 回调函数的参数 + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| taskstates | Array<[TaskState](#taskstate9)> | 是 | 上传任务返回结果 | + +**示例:** + + ```js + uploadTask.off('complete', function callback(taskStates) { + for (let i = 0; i < taskStates.length; i++ ) { + console.info("upOnComplete taskState:" + JSON.stringify(taskStates[i])); + } + } + ); + + uploadTask.off('fail', function callback(taskStates) { + for (let i = 0; i < taskStates.length; i++ ) { + console.info("upOnFail taskState:" + JSON.stringify(taskStates[i])); + } + } + ); + ``` + ### remove @@ -444,6 +527,17 @@ remove(callback: AsyncCallback<boolean>): void | files | Array<[File](#file)> | 是 | 要上传的文件列表。请使用 multipart/form-data提交。 | | data | Array<[RequestData](#requestdata)> | 是 | 请求的表单数据。 | +## TaskState9+ + +**需要权限**:ohos.permission.INTERNET + +**系统能力**: 以下各项对应的系统能力均为SystemCapability.MiscServices.Upload。 + +| 名称 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| path | string | 是 | 文件路径 | +| responseCode | number | 是 | 上传任务返回值 | +| message | string | 是 | 上传任务结果描述信息 | ## File