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