Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d0546649
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
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看板
提交
d0546649
编写于
3月 07, 2022
作者:
C
clevercong
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
format files.
Signed-off-by:
N
clevercong
<
lichunlin2@huawei.com
>
上级
15f36103
变更
3
展开全部
隐藏空白更改
内联
并排
Showing
3 changed file
with
236 addition
and
287 deletion
+236
-287
zh-cn/application-dev/reference/apis/js-apis-http.md
zh-cn/application-dev/reference/apis/js-apis-http.md
+47
-79
zh-cn/application-dev/reference/apis/js-apis-socket.md
zh-cn/application-dev/reference/apis/js-apis-socket.md
+141
-146
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
+48
-62
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-http.md
浏览文件 @
d0546649
# 数据请求<a name="ZH-CN_TOPIC_0000001171944450"></a>
-
[
导入模块
](
#s56d19203690d4782bfc74069abb6bd71
)
-
[
权限列表
](
#section11257113618419
)
-
[
完整示例
](
#section119676440437
)
-
[
http.createHttp
](
#section375081875219
)
-
[
HttpRequest
](
#section775213486457
)
-
[
request
](
#section08941433184616
)
-
[
request
](
#section1361727114718
)
-
[
request
](
#section47538114482
)
-
[
destroy
](
#section613614500483
)
-
[
on\('headerReceive'\)
](
#section617831813498
)
-
[
off\('headerReceive'\)
](
#section017612118508
)
-
[
on\('headersReceive'\)<sup>8+</sup>
](
#section6178318134982
)
-
[
off\('headersReceive'\)<sup>8+</sup>
](
#section0176121185082
)
-
[
once\('headersReceive'\)<sup>8+</sup>
](
#section68221041134718
)
-
[
HttpRequestOptions
](
#section12262183471518
)
-
[
RequestMethod
](
#section63024410264
)
-
[
ResponseCode
](
#section769218832018
)
-
[
HttpResponse
](
#section15920192914312
)
# 数据请求
> **说明:**
>
...
...
@@ -25,17 +6,13 @@
>
>本模块所有接口需要设备具有系统能力:SystemCapability.Communication.NetStack
## 导入模块
<a name="s56d19203690d4782bfc74069abb6bd71"></a>
## 导入模块
```
import http from '@ohos.net.http';
```
## 权限列表<a name="section11257113618419"></a>
ohos.permission.INTERNET
## 完整示例<a name="section119676440437"></a>
## 完整示例
```
import http from '@ohos.net.http';
...
...
@@ -80,7 +57,7 @@ httpRequest.request(
);
```
## http.createHttp
<a name="section375081875219"></a>
## http.createHttp
createHttp
\(\)
: HttpRequest
...
...
@@ -100,22 +77,24 @@ let httpRequest = http.createHttp();
```
## HttpRequest
<a name="section775213486457"></a>
## HttpRequest
http请求任务。在调用HttpRequest的方法前,需要先通过
[
createHttp\(\)
](
#
section375081875219
)
创建一个任务。
http请求任务。在调用HttpRequest的方法前,需要先通过
[
createHttp\(\)
](
#
httpcreatehttp
)
创建一个任务。
### request
<a name="section08941433184616"></a>
### request
request
\(
url: string, callback: AsyncCallback
\<
HttpResponse
\>\)
:void
根据URL地址,发起HTTP网络请求,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------- | ---- | ----------------------- |
| url | string | 是 | 发起网络请求的URL地址。 |
| callback | AsyncCallback
\<
[
HttpResponse
](
#
section12262183471518
)
\>
| 是 | 回调函数。 |
| callback | AsyncCallback
\<
[
HttpResponse
](
#
httpresponse
)
\>
| 是 | 回调函数。 |
**示例:**
...
...
@@ -133,19 +112,21 @@ httpRequest.request("EXAMPLE_URL", (err, data) => {
});
```
### request
<a name="section1361727114718"></a>
### request
request
\(
url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpResponse
\>\)
:void
根据URL地址和相关配置项,发起HTTP网络请求,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ----------------------------------------------
--------- | ---- | ---
----------------------------------------------- |
| url | string
| 是 | 发起网络请求的URL地址。
|
| options | HttpRequestOptions
| 是 | 参考
[
HttpRequestOptions
](
#section12262183471518
)
。 |
| callback | AsyncCallback
\<
[
HttpResponse
](
#
section12262183471518
)
\>
| 是 | 回调函数。
|
| 参数名 | 类型
| 必填 | 说明
|
| -------- | ----------------------------------------------
| ---- |
----------------------------------------------- |
| url | string
| 是 | 发起网络请求的URL地址。
|
| options | HttpRequestOptions
| 是 | 参考
[
HttpRequestOptions
](
#httprequestoptions
)
。 |
| callback | AsyncCallback
\<
[
HttpResponse
](
#
httpresponse
)
\>
| 是 | 回调函数。
|
**示例:**
...
...
@@ -176,24 +157,26 @@ httpRequest.request("EXAMPLE_URL",
```
### request
<a name="section47538114482"></a>
### request
request
\(
url: string, options? : HttpRequestOptions
\)
: Promise<HttpResponse
\>
根据URL地址,发起HTTP网络请求,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------ | ---- | -------------------------------------------------- |
| url | string | 是 | 发起网络请求的URL地址。 |
| options | HttpRequestOptions | 是 | 参考
[
HttpRequestOptions
](
#
section12262183471518
)
。 |
| options | HttpRequestOptions | 是 | 参考
[
HttpRequestOptions
](
#
httprequestoptions
)
。 |
**返回值:**
| 类型 | 说明 |
| :-------------------- | :-------------------------------- |
| Promise
<
[
HttpResponse
](
#
section12262183471518
)
>
| 以Promise形式返回发起请求的结果。 |
| Promise
<
[
HttpResponse
](
#
httpresponse
)
>
| 以Promise形式返回发起请求的结果。 |
**示例:**
...
...
@@ -222,7 +205,7 @@ promise.then((value) => {
});
```
### destroy
<a name="section613614500483"></a>
### destroy
destroy
\(\)
: void
...
...
@@ -235,21 +218,21 @@ let httpRequest= http.createHttp();
httpRequest.destroy();
```
### on\('headerReceive'\)
<a name="section617831813498"></a>
### on\('headerReceive'\)
on
\(
type: 'headerReceive', callback: AsyncCallback<Object
\>\)
:void
订阅HTTP Response Header 事件。
> **说明:**
> 此接口已废弃,建议使用
on\('headersReceive'\
)替代。
> 此接口已废弃,建议使用
[on\('headersReceive'\)<sup>8+</sup>](#onheadersreceive8
)替代。
**参数:**
| 参数名 | 类型 | 必填 | 说明
|
| -------- | ----------------------- | ---- | ---------------------------------
----
|
| type | string | 是 | 订阅的事件类型,
如:
'headerReceive'。 |
| callback | AsyncCallback
\<
Object
\>
| 是 | 回调函数。
|
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | --------------------------------- |
| type | string | 是 | 订阅的事件类型,'headerReceive'。 |
| callback | AsyncCallback
\<
Object
\>
| 是 | 回调函数。 |
**示例:**
...
...
@@ -265,7 +248,7 @@ httpRequest.on('headerReceive', (err, data) => {
```
### off\('headerReceive'\)
<a name="section017612118508"></a>
### off\('headerReceive'\)
off
\(
type: 'headerReceive', callback?: AsyncCallback<Object
\>\)
:void
...
...
@@ -273,7 +256,7 @@ off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
> **说明:**
>
>1. 此接口已废弃,建议使用
off\('headersReceive'\
)替代。
>1. 此接口已废弃,建议使用
[off\('headersReceive'\)<sup>8+</sup>](#offheadersreceive8
)替代。
>
>2. 可以指定传入on中的callback取消一个订阅,也可以不指定callback清空所有订阅。
...
...
@@ -298,7 +281,7 @@ httpRequest.on('headerReceive', (err, data) => {
httpRequest.off('headerReceive');
```
### on\('headersReceive'\)<sup>8+</sup>
<a name="section6178318134982"></a>
### on\('headersReceive'\)<sup>8+</sup>
on
\(
type: 'headersReceive', callback: Callback<Object
\>\)
:void
...
...
@@ -321,7 +304,7 @@ httpRequest.on('headersReceive', (data) => {
```
### off\('headersReceive'\)<sup>8+</sup>
<a name="section0176121185082"></a>
### off\('headersReceive'\)<sup>8+</sup>
off
\(
type: 'headersReceive', callback?: Callback<Object
\>\)
:void
...
...
@@ -344,7 +327,7 @@ let httpRequest= http.createHttp();
httpRequest.off('headersReceive');
```
### once\('headersReceive'\)<sup>8+</sup>
<a name="section68221041134718"></a>
### once\('headersReceive'\)<sup>8+</sup>
once
\(
type: "headersReceive", callback: Callback<Object
\>\)
: void
...
...
@@ -366,27 +349,19 @@ httpRequest.once('headersReceive', (data) => {
});
```
## HttpRequestOptions
<a name="section12262183471518"></a>
## HttpRequestOptions
发起请求可选参数的类型和取值范围。
| 参数 | 类型 | 必填 | 说明 |
| -------------- | ------------------------------------ | ---- | ---------------------------------------------------------- |
| method |
[
RequestMethod
](
#
section63024410264
)
| 否 | 请求方式。 |
| extraData | string
\|
Object
\|
ArrayBuffer
8+ | 否 | 发送请求的额外数据。详见下方说明。
|
| method |
[
RequestMethod
](
#
requestmethod
)
| 否 | 请求方式。 |
| extraData | string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 否 | 发送请求的额外数据。
<br
/>
- 当HTTP请求为POST、PUT等方法时,此字段为HTTP请求的content。
<br
/>
- 当HTTP请求为GET、OPTIONS、DELETE、TRACE、CONNECT等方法时,此字段为HTTP请求的参数补充,参数内容会拼接到URL中进行发送。
<sup>
8+
</sup><br
/>
- 开发者传入string对象,开发者需要自行编码,将编码后的string传入。
<sup>
8+
</sup>
|
| header | Object | 否 | HTTP请求头字段。默认{'Content-Type': 'application/json'}。 |
| readTimeout | number | 否 | 读取超时时间。单位为毫秒(ms),默认为60000ms。 |
| connectTimeout | number | 否 | 连接超时时间。单位为毫秒(ms),默认为60000ms。 |
>  **说明:**
>
> 1. 当HTTP请求为POST、PUT等方法时,此字段为HTTP请求的content。
>
> 2. 当HTTP请求为GET、OPTIONS、DELETE、TRACE、CONNECT等方法时,此字段为HTTP请求的参数补充,参数内容会拼接到URL中进行发送。8+
>
> 3. 开发者传入string对象,开发者需要自行编码,将编码后的string传入。8+
## RequestMethod<a name="section63024410264"></a>
## RequestMethod
HTTP 请求方法。
...
...
@@ -401,7 +376,7 @@ HTTP 请求方法。
| TRACE | HTTP 请求 TRACE。 |
| CONNECT | HTTP 请求 CONNECT。 |
## ResponseCode
<a name="section769218832018"></a>
## ResponseCode
发起请求返回的响应码。
...
...
@@ -443,21 +418,14 @@ HTTP 请求方法。
| GATEWAY_TIMEOUT | 504 | 充当网关或代理的服务器,未及时从远端服务器获取请求。 |
| VERSION | 505 | 服务器请求的HTTP协议的版本。 |
## HttpResponse
<a name="section15920192914312"></a>
## HttpResponse
request方法回调函数的返回值类型。
| 参数名
| 类型
| 必填 | 说明 |
| ------------
| --
-------------------------------------------- | ---- | ------------------------------------------------------------ |
| result
| string
\|
Object
\|
ArrayBuffer8+ | 是 | Http请求根据响应头中Content-type类型返回对应的响应格式内容。详见下方说明。
|
| responseCode
|
[
ResponseCode
](
#section769218832018
)
\|
number | 是 | 回调函数执行成功时,此字段为
[
ResponseCode
](
#section769218832018
)
。若执行失败,错误码将会从AsyncCallback中的err字段返回。错误码如下:
<br
/>
- 200:通用错误
<br
/>
- 202:参数错误
<br
/>
- 300:I/O错误 |
| header
| Object
| 是 | 发起http请求返回来的响应头。当前返回的是JSON格式字符串,如需具体字段内容,需开发者自行解析。常见字段及解析方式如下:
<br/>
- Content-Type:header['Content-Type'];
<br
/>
- Status-Line:header['Status-Line'];
<br
/>
- Date:header.Date/header['Date'];
<br
/>
- Server:header.Server/header['Server']; |
| cookies
8+ | Array
\<
string
\>
| 是 | 服务器返回的 cookies。 |
| 参数名
| 类型
| 必填 | 说明 |
| ------------
-------- |
-------------------------------------------- | ---- | ------------------------------------------------------------ |
| result
| string
\|
Object
\|
ArrayBuffer
<sup>
8+
</sup>
| 是 | Http请求根据响应头中Content-type类型返回对应的响应格式内容:
<br
/>
- application/json:返回JSON格式的字符串,如需Http响应具体内容,需开发者自行解析
<br
/>
- application/octet-stream:ArrayBuffer
<br
/>
- 其他:string
|
| responseCode
|
[
ResponseCode
](
#responsecode
)
\|
number | 是 | 回调函数执行成功时,此字段为
[
ResponseCode
](
#responsecode
)
。若执行失败,错误码将会从AsyncCallback中的err字段返回。错误码如下:
<br
/>
- 200:通用错误
<br
/>
- 202:参数错误
<br
/>
- 300:I/O错误 |
| header
| Object
| 是 | 发起http请求返回来的响应头。当前返回的是JSON格式字符串,如需具体字段内容,需开发者自行解析。常见字段及解析方式如下:
<br/>
- Content-Type:header['Content-Type'];
<br
/>
- Status-Line:header['Status-Line'];
<br
/>
- Date:header.Date/header['Date'];
<br
/>
- Server:header.Server/header['Server']; |
| cookies
<sup>
8+
</sup>
| Array
\<
string
\>
| 是 | 服务器返回的 cookies。 |
>  **说明:**
>
> 根据响应头中Content-type类型的不同,返回的类型不同:
>
> - application/json:返回JSON格式的字符串,如需Http响应具体内容,需开发者自行解析
> - application/octet-stream:ArrayBuffer
> - 其他:string
zh-cn/application-dev/reference/apis/js-apis-socket.md
浏览文件 @
d0546649
此差异已折叠。
点击以展开。
zh-cn/application-dev/reference/apis/js-apis-webSocket.md
浏览文件 @
d0546649
# WebSocket连接<a name="ZH-CN_TOPIC_0000001216545901"></a>
-
[
导入模块
](
#s56d19203690d4782bfc74069abb6bd71
)
-
[
权限列表
](
#section11257113618419
)
-
[
完整示例
](
#section20761171275912
)
-
[
webSocket.createWebSocket
](
#section375081875219
)
-
[
WebSocket
](
#section16411174314593
)
-
[
connect
](
#section1377525513113
)
-
[
connect
](
#section18952991528
)
-
[
connect
](
#section10573126422
)
-
[
send
](
#section156451414213
)
-
[
send
](
#section137609541324
)
-
[
close
](
#section202411451433
)
-
[
close
](
#section10491513437
)
-
[
close
](
#section118451219536
)
-
[
on\('open'\)
](
#section923017271834
)
-
[
off\('open'\)
](
#section207051331730
)
-
[
on\('message'\)
](
#section1066819418488
)
-
[
off\('message'\)
](
#section1467019413484
)
-
[
on\('close'\)
](
#section169378107484
)
-
[
off\('close'\)
](
#section993911074812
)
-
[
on\('error'\)
](
#section2997161484815
)
-
[
off\('error'\)
](
#section13999114164815
)
-
[
WebSocketRequestOptions
](
#section11251233123910
)
-
[
WebSocketCloseOptions
](
#section12262183471518
)
-
[
close错误码说明
](
#section1635681416477
)
# WebSocket连接
> **说明:**
>本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
>当前暂时不支持WebSocket,预计在MR版本支持。
使用WebSocket建立服务器与客户端的双向连接,需要先通过
[
createWebSocket
](
#
section375081875219
)
方法创建
[
WebSocket
](
#section16411174314593
)
对象,然后通过
[
connect
](
WebSocket连接.md
)
方法连接到服务器。当连接成功后,客户端会收到
[
open
](
#section923017271834
)
事件的回调,之后客户端就可以通过
[
send
](
#section156451414213
)
方法与服务器进行通信。当服务器发信息给客户端时,客户端会收到
[
message
](
#section1066819418488
)
事件的回调。当客户端不要此连接时,可以通过调用
[
close
](
#section202411451433
)
方法主动断开连接,之后客户端会收到
[
close
](
#section169378107484
)
事件的回调。
使用WebSocket建立服务器与客户端的双向连接,需要先通过
[
createWebSocket
](
#
webSocketcreatewebsocket
)
方法创建
[
WebSocket
](
#websocket
)
对象,然后通过
[
connect
](
#connect
)
方法连接到服务器。当连接成功后,客户端会收到
[
open
](
#onopen
)
事件的回调,之后客户端就可以通过
[
send
](
#send
)
方法与服务器进行通信。当服务器发信息给客户端时,客户端会收到
[
message
](
#onmessage
)
事件的回调。当客户端不要此连接时,可以通过调用
[
close
](
#close
)
方法主动断开连接,之后客户端会收到
[
close
](
#onclose
)
事件的回调。
若在上述任一过程中发生错误,客户端会收到
[
error
](
#
section2997161484815
)
事件的回调。
若在上述任一过程中发生错误,客户端会收到
[
error
](
#
onerror
)
事件的回调。
## 导入模块
<a name="s56d19203690d4782bfc74069abb6bd71"></a>
## 导入模块
```
import webSocket from '@ohos.net.webSocket';
```
## 权限列表<a name="section11257113618419"></a>
需要ohos.permission.INTERNET权限。
## 完整示例<a name="section20761171275912"></a>
## 完整示例
```
import webSocket from '@ohos.net.webSocket';
...
...
@@ -92,7 +62,7 @@ ws.connect(defaultIpAddress, (err, value) => {
});
```
## webSocket.createWebSocket
<a name="section375081875219"></a>
## webSocket.createWebSocket
createWebSocket
\(\)
: WebSocket
...
...
@@ -102,7 +72,7 @@ createWebSocket\(\): WebSocket
| 类型 | 说明 |
| :---------------------------------- | :----------------------------------------------------------- |
|
[
WebSocket
](
#
section16411174314593
)
| 返回一个WebSocket对象,里面包括connect、send、close、on和off方法。 |
|
[
WebSocket
](
#
websocket
)
| 返回一个WebSocket对象,里面包括connect、send、close、on和off方法。 |
**示例:**
...
...
@@ -111,16 +81,18 @@ let ws = webSocket.createWebSocket();
```
## WebSocket
<a name="section16411174314593"></a>
## WebSocket
在调用WebSocket的方法前,需要先通过
[
webSocket.createWebSocket
](
#
section375081875219
)
创建一个WebSocket。
在调用WebSocket的方法前,需要先通过
[
webSocket.createWebSocket
](
#
webSocketcreatewebsocket
)
创建一个WebSocket。
### connect
<a name="section1377525513113"></a>
### connect
connect
\(
url: string, callback: AsyncCallback<boolean
\>\)
: void
根据URL地址,建立一个WebSocket连接,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -144,18 +116,20 @@ ws.connect(url, (err, value) => {
```
### connect
<a name="section18952991528"></a>
### connect
connect
\(
url: string, options: WebSocketRequestOptions, callback: AsyncCallback<boolean
\>\)
: void
根据URL地址和header,建立一个WebSocket连接,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | ------------------------------------------------------- |
| url | string | 是 | 建立WebSocket连接的URL地址。 |
| options | WebSocketRequestOptions | 是 | 参考
[
WebSocketRequestOptions
](
#
section11251233123910
)
。 |
| options | WebSocketRequestOptions | 是 | 参考
[
WebSocketRequestOptions
](
#
websocketrequestoptions
)
。 |
| callback | AsyncCallback
\<
boolean
\>
| 是 | 回调函数。 |
...
...
@@ -179,18 +153,20 @@ ws.connect(url, {
```
### connect
<a name="section10573126422"></a>
### connect
connect
\(
url: string, options?: WebSocketRequestOptions
\)
: Promise<boolean
\>
根据URL地址和header,建立一个WebSocket连接,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ----------------------- | ---- | ------------------------------------------------------- |
| url | string | 是 | 建立WebSocket连接的URL地址。 |
| options | WebSocketRequestOptions | 否 | 参考
[
WebSocketRequestOptions
](
#
section11251233123910
)
。 |
| options | WebSocketRequestOptions | 否 | 参考
[
WebSocketRequestOptions
](
#
websocketrequestoptions
)
。 |
**返回值:**
...
...
@@ -212,12 +188,14 @@ promise.then((value) => {
```
### send
<a name="section156451414213"></a>
### send
send
\(
data: string | ArrayBuffer, callback: AsyncCallback<boolean
\>\)
: void
通过WebSocket连接发送数据,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -242,12 +220,14 @@ ws.connect(url, (err, value) => {
```
### send
<a name="section137609541324"></a>
### send
send
\(
data: string | ArrayBuffer
\)
: Promise<boolean
\>
通过WebSocket连接发送数据,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -276,12 +256,14 @@ ws.connect(url, (err, value) => {
```
### close
<a name="section202411451433"></a>
### close
close
\(
callback: AsyncCallback<boolean
\>\)
: void
关闭WebSocket连接,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
...
...
@@ -303,17 +285,19 @@ ws.close((err, value) => {
```
### close
<a name="section10491513437"></a>
### close
close
\(
options: WebSocketCloseOptions, callback: AsyncCallback<boolean
\>\)
: void
根据可选参数code和reason,关闭WebSocket连接,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | ----------------------------------------------------- |
| options | WebSocketCloseOptions | 是 | 参考
[
WebSocketCloseOptions
](
#
section12262183471518
)
。 |
| options | WebSocketCloseOptions | 是 | 参考
[
WebSocketCloseOptions
](
#
websocketcloseoptions
)
。 |
| callback | AsyncCallback
\<
boolean
\>
| 是 | 回调函数。 |
**示例:**
...
...
@@ -334,17 +318,19 @@ ws.close({
```
### close
<a name="section118451219536"></a>
### close
close
\(
options?: WebSocketCloseOptions
\)
: Promise<boolean
\>
根据可选参数code和reason,关闭WebSocket连接,使用Promise方式作为异步方法。
**需要权限**
:ohos.permission.INTERNET
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------- | ---- | ----------------------------------------------------- |
| options | WebSocketCloseOptions | 否 | 参考
[
WebSocketCloseOptions
](
#
section12262183471518
)
。 |
| options | WebSocketCloseOptions | 否 | 参考
[
WebSocketCloseOptions
](
#
websocketcloseoptions
)
。 |
**返回值:**
...
...
@@ -369,7 +355,7 @@ promise.then((value) => {
```
### on\('open'\)
<a name="section923017271834"></a>
### on\('open'\)
on
\(
type: 'open', callback: AsyncCallback<Object
\>\)
: void
...
...
@@ -393,7 +379,7 @@ ws.on('open', (err, value) => {
```
### off\('open'\)
<a name="section207051331730"></a>
### off\('open'\)
off
\(
type: 'open', callback?: AsyncCallback<Object
\>\)
: void
...
...
@@ -422,7 +408,7 @@ ws.off('open', callback1);
```
### on\('message'\)
<a name="section1066819418488"></a>
### on\('message'\)
on
\(
type: 'message', callback: AsyncCallback<string | ArrayBuffer
\>\)
: void
...
...
@@ -449,7 +435,7 @@ ws.on('message', (err, value) => {
```
### off\('message'\)
<a name="section1467019413484"></a>
### off\('message'\)
off
\(
type: 'message', callback?: AsyncCallback<string | ArrayBuffer
\>\)
: void
...
...
@@ -474,7 +460,7 @@ ws.off('message');
```
### on\('close'\)
<a name="section169378107484"></a>
### on\('close'\)
on
\(
type: 'close', callback: AsyncCallback<
\{
code: number, reason: string
\}\>\)
: void
...
...
@@ -497,7 +483,7 @@ ws.on('close', (err, value) => {
```
### off\('close'\)
<a name="section993911074812"></a>
### off\('close'\)
off
\(
type: 'close', callback?: AsyncCallback<
\{
code: number, reason: string
\}\>\)
: void
...
...
@@ -522,7 +508,7 @@ ws.off('close');
```
### on\('error'\)
<a name="section2997161484815"></a>
### on\('error'\)
on
\(
type: 'error', callback: ErrorCallback
\)
: void
...
...
@@ -546,7 +532,7 @@ ws.on('error', (err) => {
```
### off\('error'\)
<a name="section13999114164815"></a>
### off\('error'\)
off
\(
type: 'error', callback?: ErrorCallback
\)
: void
...
...
@@ -570,7 +556,7 @@ ws.off('error');
```
## WebSocketRequestOptions
<a name="section11251233123910"></a>
## WebSocketRequestOptions
建立WebSocket连接时,可选参数的类型和说明。
...
...
@@ -579,7 +565,7 @@ ws.off('error');
| header | Object | 否 | 建立WebSocket连接可选参数,代表建立连接时携带的HTTP头信息。参数内容自定义,也可以不指定。 |
## WebSocketCloseOptions
<a name="section12262183471518"></a>
## WebSocketCloseOptions
关闭WebSocket连接时,可选参数的类型和说明。
...
...
@@ -588,7 +574,7 @@ ws.off('error');
| code | number | 否 | 错误码,关闭WebSocket连接时的可选参数,可根据实际情况来填。默认值为1000。 |
| reason | string | 否 | 原因值,关闭WebSocket连接时的可选参数,可根据实际情况来填。默认值为空字符串("")。 |
## close错误码说明
<a name="section1635681416477"></a>
## close错误码说明
发送给服务端的错误码可以自行定义,下面的列表仅供参考。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录