Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
75564209
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
75564209
编写于
7月 30, 2022
作者:
A
anyueling
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
修改md文档
Signed-off-by:
N
anyueling
<
anyueling@huawei.com
>
上级
73142fa0
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
183 addition
and
13 deletion
+183
-13
zh-cn/application-dev/reference/apis/js-apis-request.md
zh-cn/application-dev/reference/apis/js-apis-request.md
+183
-13
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-request.md
浏览文件 @
75564209
...
...
@@ -31,7 +31,7 @@ var config = {
}
```
在开发stage模型下的应用程序时,
需要在module.json和app.json配置文件中对应用结构进行声明,
不涉及属性标识 "cleartextTraffic"。
在开发stage模型下的应用程序时,不涉及属性标识 "cleartextTraffic"。
...
...
@@ -65,7 +65,7 @@ var config = {
| SESSION_SUCCESSFUL
<sup>
7+
</sup>
| number | 是 | 否 | 下载会话已完成。 |
## request.upload
## request.upload
<sup>6+</sup>
upload(config: UploadConfig): Promise
<
UploadTask
>
...
...
@@ -75,6 +75,8 @@ upload(config: UploadConfig): Promise<UploadTask>
**系统能力**
: SystemCapability.MiscServices.Upload
**模型说明**
: 此接口仅可在FA模型下使用
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -90,11 +92,15 @@ upload(config: UploadConfig): Promise<UploadTask>
**示例:**
```
js
let
file1
=
{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
};
let
data
=
{
name
:
"
name123
"
,
value
:
"
123
"
};
let
header
=
{
key1
:
"
value1
"
,
key2
:
"
value2
"
};
let
uploadTask
;
request
.
upload
({
url
:
'
https://patch
'
,
header
:
header
,
method
:
"
POST
"
,
files
:
[
file1
],
data
:
[
data
]
}).
then
((
data
)
=>
{
let
uploadConfig
=
{
url
:
'
https://patch
'
,
header
:
{
key1
:
"
value1
"
,
key2
:
"
value2
"
},
method
:
"
POST
"
,
files
:
[{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
}],
data
:
[{
name
:
"
name123
"
,
value
:
"
123
"
}],
};
request
.
upload
(
uploadConfig
).
then
((
data
)
=>
{
uploadTask
=
data
;
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to request the upload. Cause:
'
+
JSON
.
stringify
(
err
));
...
...
@@ -102,7 +108,7 @@ upload(config: UploadConfig): Promise<UploadTask>
```
## request.upload
## request.upload
<sup>6+</sup>
upload(config: UploadConfig, callback: AsyncCallback
<
UploadTask
>
): void
...
...
@@ -112,6 +118,8 @@ upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void
**系统能力**
: SystemCapability.MiscServices.Upload
**模型说明**
: 此接口仅可在FA模型下使用
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
...
...
@@ -122,11 +130,15 @@ upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void
**示例:**
```
js
let
file1
=
{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
};
let
data
=
{
name
:
"
name123
"
,
value
:
"
123
"
};
let
header
=
{
key1
:
"
value1
"
,
key2
:
"
value2
"
};
let
uploadTask
;
request
.
upload
({
url
:
'
https://patch
'
,
header
:
header
,
method
:
"
POST
"
,
files
:
[
file1
],
data
:
[
data
]
},
(
err
,
data
)
=>
{
let
uploadConfig
=
{
url
:
'
https://patch
'
,
header
:
{
key1
:
"
value1
"
,
key2
:
"
value2
"
},
method
:
"
POST
"
,
files
:
[{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
}],
data
:
[{
name
:
"
name123
"
,
value
:
"
123
"
}],
};
request
.
upload
(
uploadConfig
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to request the upload. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
...
...
@@ -134,7 +146,92 @@ upload(config: UploadConfig, callback: AsyncCallback<UploadTask>): void
uploadTask
=
data
;
});
```
## request.upload<sup>9+</sup>
upload(context: BaseContext,config: UploadConfig): Promise
<
UploadTask
>
上传,异步方法,使用promise形式返回结果。
**需要权限**
:ohos.permission.INTERNET
**系统能力**
: SystemCapability.MiscServices.Upload
**模型说明**
: 此接口仅可在Stage模型下使用
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
BaseContext
](
#baseContext
)
| 是 | 基于应用程序的上下文。 |
| config |
[
UploadConfig
](
#uploadconfig
)
| 是 | 上传的配置信息。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
[UploadTask](#uploadtask)
>
| 返回上传任务。 |
**示例:**
```
js
let
uploadTask
;
let
uploadConfig
=
{
url
:
'
https://patch
'
,
header
:
{
key1
:
"
value1
"
,
key2
:
"
value2
"
},
method
:
"
POST
"
,
files
:
{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
},
data
:
{
name
:
"
name123
"
,
value
:
"
123
"
},
}
request
.
upload
(
globalThis
.
abilityContext
,
uploadConfig
).
then
((
data
)
=>
{
uploadTask
=
data
;
}).
catch
((
err
)
=>
{
console
.
error
(
'
Failed to request the upload. Cause:
'
+
JSON
.
stringify
(
err
));
})
```
## request.upload<sup>9+</sup>
upload(config: UploadConfig, callback: AsyncCallback
<
UploadTask
>
): void
upload(context: BaseContext,config: UploadConfig, callback: AsyncCallback
<
UploadTask
>
): void
上传,异步方法,使用callback形式返回结果。
**需要权限**
:ohos.permission.INTERNET
**系统能力**
: SystemCapability.MiscServices.Upload
**模型说明**
: 此接口仅可在Stage模型下使用
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
BaseContext
](
#baseContext
)
| 是 | 基于应用程序的上下文。 |
| config |
[
UploadConfig
](
#uploadconfig
)
| 是 | 上传的配置信息。 |
| callback | AsyncCallback
<
[UploadTask](#uploadtask)
>
| 否 | 回调函数,异步返回UploadTask对象。 |
**示例:**
```
js
let
uploadTask
;
let
uploadConfig
=
{
url
:
'
https://patch
'
,
header
:
{
key1
:
"
value1
"
,
key2
:
"
value2
"
},
method
:
"
POST
"
,
files
:
[{
filename
:
"
test
"
,
name
:
"
test
"
,
uri
:
"
internal://cache/test.jpg
"
,
type
:
"
jpg
"
}],
data
:
[{
name
:
"
name123
"
,
value
:
"
123
"
}],
};
request
.
upload
(
globalThis
.
abilityContext
,
uploadConfig
,
(
err
,
data
)
=>
{
if
(
err
)
{
console
.
error
(
'
Failed to request the upload. Cause:
'
+
JSON
.
stringify
(
err
));
return
;
}
uploadTask
=
data
;
});
```
## UploadTask
...
...
@@ -379,7 +476,7 @@ remove(callback: AsyncCallback<boolean>): void
| value | string | 是 | 表示表单元素的值。 |
## request.download
## request.download
<sup>6+</sup>
download(config: DownloadConfig): Promise
<
DownloadTask
>
...
...
@@ -389,6 +486,8 @@ download(config: DownloadConfig): Promise<DownloadTask>
**系统能力**
: SystemCapability.MiscServices.Download
**模型说明**
: 此接口仅可在FA模型下使用
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -413,7 +512,7 @@ download(config: DownloadConfig): Promise<DownloadTask>
```
## request.download
## request.download
<sup>6+</sup>
download(config: DownloadConfig, callback: AsyncCallback
<
DownloadTask
>
): void
...
...
@@ -423,6 +522,8 @@ download(config: DownloadConfig, callback: AsyncCallback<DownloadTask>): v
**系统能力**
: SystemCapability.MiscServices.Download
**模型说明**
: 此接口仅可在FA模型下使用
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
...
...
@@ -444,7 +545,76 @@ download(config: DownloadConfig, callback: AsyncCallback<DownloadTask>): v
});
```
## request.download<sup>9+</sup>
download(config: DownloadConfig): Promise
<
DownloadTask
>
下载,异步方法,使用promise形式返回结果。
**需要权限**
:ohos.permission.INTERNET
**系统能力**
: SystemCapability.MiscServices.Download
**模型说明**
: 此接口仅可在Stage模型下使用
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
BaseContext
](
#baseContext
)
| 是 | 基于应用程序的上下文。 |
| config |
[
DownloadConfig
](
#downloadconfig
)
| 是 | 下载的配置信息。 |
**返回值:**
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
[DownloadTask](#downloadtask)
>
| 返回下载任务。 |
**示例:**
```
js
let
downloadTask
;
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
));
})
```
## request.download<sup>9+</sup>
download(config: DownloadConfig, callback: AsyncCallback
<
DownloadTask
>
): void
下载,异步方法,使用callback形式返回结果。
**需要权限**
:ohos.permission.INTERNET
**系统能力**
: SystemCapability.MiscServices.Download
**模型说明**
: 此接口仅可在Stage模型下使用
**参数:**
| 参数名 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| config |
[
BaseContext
](
#baseContext
)
| 是 | 基于应用程序的上下文。 |
| config |
[
DownloadConfig
](
#downloadconfig
)
| 是 | 下载的配置信息。 |
| callback | AsyncCallback
<
[DownloadTask](#downloadtask)
>
| 否 | 下载接口的回调函数。 |
**示例:**
```
js
let
downloadTask
;
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
));
return
;
}
downloadTask
=
data
;
});
```
## DownloadTask
下载任务。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录