!1806 update js api docs.

Merge pull request !1806 from clevercong/submitnetstack

zh-cn/application-dev/reference/apis/js-apis-http.md

+# 数据请求
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>
+>本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+>
+>本模块所有接口需要设备具有系统能力：SystemCapability.Communication.NetStack
+
+## 导入模块
+
+```
+import http from '@ohos.net.http';
+```
+
+## 完整示例
+
+```
+import http from '@ohos.net.http';
+
+// 每一个httpRequest对应一个http请求任务，不可复用
+let httpRequest = http.createHttp();
+// 用于订阅http响应头，此接口会比request请求先返回。可以根据业务需要订阅此消息
+// 从API 8开始，使用on('headersReceive', Callback)替代on('headerReceive', AsyncCallback)。 8+
+httpRequest.on('headersReceive', (data) => {
+    console.info('header: ' + data.header);
+});
+httpRequest.request(
+    // 填写http请求的url地址，可以带参数也可以不带参数。URL地址需要开发者自定义。GET请求的参数可以在extraData中指定
+    "EXAMPLE_URL",
+    {
+        method: 'POST', // 可选，默认为“GET”
+        // 开发者根据自身业务需要添加header字段
+        header: {
+            'Content-Type': 'application/json'
+        },
+        // 当使用POST请求时此字段用于传递内容
+ 
+        extraData: {
+            "data": "data to send",
+        },
+        connectTimeout: 60000, // 可选，默认为60s
+        readTimeout: 60000, // 可选，默认为60s
+    },(err, data) => {
+        if (!err) {
+            // data.result为http响应内容，可根据业务需要进行解析
+            console.info('Result:' + data.result);
+            console.info('code:' + data.responseCode);
+            // data.header为http响应头，可根据业务需要进行解析
+            console.info('header:' + data.header);
+            console.info('cookies:' + data.cookies); // 8+
+        } else {
+            console.info('error:' + err);
+            // 当该请求使用完毕时，调用destroy方法主动销毁。
+            httpRequest.destroy();
+        }
+    }
+);
+```
+
+## http.createHttp
+
+createHttp\(\): HttpRequest
+
+创建一个http，里面包括发起请求、中断请求、订阅/取消订阅HTTP Response Header 事件。每一个HttpRequest对象对应一个Http请求。如需发起多个Http请求，须为每个Http请求创建对应HttpRequest对象。
+
+**返回值：**
+
+| 类型        | 说明                                                         |
+| :---------- | :----------------------------------------------------------- |
+| HttpRequest | 返回一个HttpRequest对象，里面包括request、destroy、on和off方法。 |
+
+**示例：**
+
+```
+import http from '@ohos.net.http';
+let httpRequest = http.createHttp();
+```
+
+
+## HttpRequest
+
+http请求任务。在调用HttpRequest的方法前，需要先通过[createHttp\(\)](#httpcreatehttp)创建一个任务。
+
+### request
+
+request\(url: string, callback: AsyncCallback\<HttpResponse\>\):void
+
+根据URL地址，发起HTTP网络请求，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                                                    | 必填 | 说明                    |
+| -------- | ------------------------------------------------------- | ---- | ----------------------- |
+| url      | string                                                  | 是   | 发起网络请求的URL地址。 |
+| callback | AsyncCallback\<[HttpResponse](#httpresponse)\> | 是   | 回调函数。              |
+
+**示例：**
+
+```
+let httpRequest = http.createHttp();
+httpRequest.request("EXAMPLE_URL", (err, data) => {
+  if (!err) {
+    console.info('Result:' + data.result);
+    console.info('code:' + data.responseCode);
+    console.info('header:' + data.header);
+    console.info('cookies:' + data.cookies); // 8+
+  } else {
+    console.info('error:' + err.data);
+  }
+});
+```
+
+### request
+
+request\(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpResponse\>\):void
+
+根据URL地址和相关配置项，发起HTTP网络请求，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                                           | 必填 | 说明                                            |
+| -------- | ---------------------------------------------- | ---- | ----------------------------------------------- |
+| url      | string                                         | 是   | 发起网络请求的URL地址。                         |
+| options  | HttpRequestOptions                             | 是   | 参考[HttpRequestOptions](#httprequestoptions)。 |
+| callback | AsyncCallback\<[HttpResponse](#httpresponse)\> | 是   | 回调函数。                                      |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.request("EXAMPLE_URL",
+{
+  method: 'GET',
+  header: {
+	'Content-Type': 'application/json'
+  },
+  readTimeout: 60000,
+  connectTimeout: 60000
+},(err, data) => {
+  if (!err) {
+	console.info('Result:' + data.result);
+	console.info('code:' + data.responseCode);
+	console.info('header:' + data.header);
+	console.info('cookies:' + data.cookies); // 8+
+	console.info('header['Content-Type']:' + data.header['Content-Type']);
+	console.info('header['Status-Line']:' + data.header['Status-Line']);
+	console.info('header.Date:' + data.header.Date);
+	console.info('header.Server:' + data.header.Server);
+  } else {
+	console.info('error:' + err.data);
+  }
+});
+```
+
+
+### request
+
+request\(url: string, options? : HttpRequestOptions\): Promise<HttpResponse\>
+
+根据URL地址，发起HTTP网络请求，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名  | 类型               | 必填 | 说明                                               |
+| ------- | ------------------ | ---- | -------------------------------------------------- |
+| url     | string             | 是   | 发起网络请求的URL地址。                            |
+| options | HttpRequestOptions | 是   | 参考[HttpRequestOptions](#httprequestoptions)。 |
+
+**返回值：**
+
+| 类型                  | 说明                              |
+| :-------------------- | :-------------------------------- |
+| Promise<[HttpResponse](#httpresponse)> | 以Promise形式返回发起请求的结果。 |
+
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+let promise = httpRequest.request("EXAMPLE_URL", {
+  method: "GET",
+  connectTimeout: 60000,
+  readTimeout: 60000,
+  header: {
+	'Content-Type': 'application/json'
+  }
+});
+promise.then((value) => {
+	console.info('Result:' + value.result);
+	console.info('code:' + value.responseCode);
+	console.info('header:' + value.header);
+	console.info('cookies:' + value.cookies); // 8+
+	console.info('header['Content-Type']:' + value.header['Content-Type']);
+	console.info('header['Status-Line']:' + value.header['Status-Line']);
+	console.info('header.Date:' + value.header.Date);
+	console.info('header.Server:' + value.header.Server);
+}).catch((err) => {
+	console.error(`errCode:${err.code}, errMessage:${err.data}`);
+});
+```
+
+### destroy
+
+destroy\(\): void
+
+中断请求任务。
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.destroy();
+```
+
+### on\('headerReceive'\)
+
+on\(type: 'headerReceive', callback: AsyncCallback<Object\>\):void
+
+订阅HTTP Response Header 事件。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+> 此接口已废弃，建议使用[on\('headersReceive'\)<sup>8+</sup>](#onheadersreceive8)替代。
+
+**参数：**
+
+| 参数名   | 类型                    | 必填 | 说明                              |
+| -------- | ----------------------- | ---- | --------------------------------- |
+| type     | string                  | 是   | 订阅的事件类型，'headerReceive'。 |
+| callback | AsyncCallback\<Object\> | 是   | 回调函数。                        |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.on('headerReceive', (err, data) => {
+  if (!err) {
+	console.info('header: ' + data.header);
+  } else {
+	console.info('error:' + err.data);
+  }
+});
+```
+
+
+### off\('headerReceive'\)
+
+off\(type: 'headerReceive', callback?: AsyncCallback<Object\>\):void
+
+取消订阅HTTP Response Header 事件。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>
+>1. 此接口已废弃，建议使用[off\('headersReceive'\)<sup>8+</sup>](#offheadersreceive8)替代。
+>
+>2. 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型                    | 必填 | 说明                                  |
+| -------- | ----------------------- | ---- | ------------------------------------- |
+| type     | string                  | 是   | 取消订阅的事件类型，'headerReceive'。 |
+| callback | AsyncCallback\<Object\> | 否   | 回调函数。                            |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.on('headerReceive', (err, data) => {
+  if (!err) {
+	console.info('header: ' + data.header);
+  } else {
+	console.info('error:' + err.data);
+  }
+});
+httpRequest.off('headerReceive');
+```
+
+### on\('headersReceive'\)<sup>8+</sup>
+
+on\(type: 'headersReceive', callback: Callback<Object\>\):void
+
+订阅HTTP Response Header 事件。
+
+**参数：**
+
+| 参数名   | 类型               | 必填 | 说明                               |
+| -------- | ------------------ | ---- | ---------------------------------- |
+| type     | string             | 是   | 订阅的事件类型：'headersReceive'。 |
+| callback | Callback\<Object\> | 是   | 回调函数。                         |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.on('headersReceive', (data) => {
+  console.info('header: ' + data.header);
+});
+```
+
+
+### off\('headersReceive'\)<sup>8+</sup>
+
+off\(type: 'headersReceive', callback?: Callback<Object\>\):void
+
+取消订阅HTTP Response Header 事件。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型               | 必填 | 说明                                   |
+| -------- | ------------------ | ---- | -------------------------------------- |
+| type     | string             | 是   | 取消订阅的事件类型：'headersReceive'。 |
+| callback | Callback\<Object\> | 否   | 回调函数。                             |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.off('headersReceive');
+```
+
+### once\('headersReceive'\)<sup>8+</sup>
+
+once\(type: "headersReceive", callback: Callback<Object\>\): void
+
+订阅HTTP Response Header 事件，但是只触发一次。一旦触发之后，订阅器就会被移除。使用callback方式作为异步方法。
+
+**参数：**
+
+| 参数名   | 类型               | 必填 | 说明                               |
+| -------- | ------------------ | ---- | ---------------------------------- |
+| type     | string             | 是   | 订阅的事件类型：'headersReceive'。 |
+| callback | Callback\<Object\> | 是   | 回调函数。                         |
+
+**示例：**
+
+```
+let httpRequest= http.createHttp();
+httpRequest.once('headersReceive', (data) => {
+  console.info('header: ' + data.header);
+});
+```
+
+## HttpRequestOptions
+
+发起请求可选参数的类型和取值范围。
+
+| 参数           | 类型                                 | 必填 | 说明                                                       |
+| -------------- | ------------------------------------ | ---- | ---------------------------------------------------------- |
+| 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。            |
+
+## RequestMethod
+
+HTTP 请求方法。
+
+| **method 的合法值** | 说明                |
+| :------------------ | :------------------ |
+| OPTIONS             | HTTP 请求 OPTIONS。 |
+| GET                 | HTTP 请求 GET。     |
+| HEAD                | HTTP 请求 HEAD。    |
+| POST                | HTTP 请求 POST。    |
+| PUT                 | HTTP 请求 PUT。     |
+| DELETE              | HTTP 请求 DELETE。  |
+| TRACE               | HTTP 请求 TRACE。   |
+| CONNECT             | HTTP 请求 CONNECT。 |
+
+## ResponseCode
+
+发起请求返回的响应码。
+
+| 变量              | 值   | 说明                                                         |
+| ----------------- | ---- | ------------------------------------------------------------ |
+| OK                | 200  | 请求成功。一般用于GET与POST请求。                            |
+| CREATED           | 201  | 已创建。成功请求并创建了新的资源。                           |
+| ACCEPTED          | 202  | 已接受。已经接受请求，但未处理完成。                         |
+| NOT_AUTHORITATIVE | 203  | 非授权信息。请求成功。                                       |
+| NO_CONTENT        | 204  | 无内容。服务器成功处理，但未返回内容。                       |
+| RESET             | 205  | 重置内容。                                                   |
+| PARTIAL           | 206  | 部分内容。服务器成功处理了部分GET请求。                      |
+| MULT_CHOICE       | 300  | 多种选择。                                                   |
+| MOVED_PERM        | 301  | 永久移动。请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。 |
+| MOVED_TEMP        | 302  | 临时移动。                                                   |
+| SEE_OTHER         | 303  | 查看其它地址。                                               |
+| NOT_MODIFIED      | 304  | 未修改。                                                     |
+| USE_PROXY         | 305  | 使用代理。                                                   |
+| BAD_REQUEST       | 400  | 客户端请求的语法错误，服务器无法理解。                       |
+| UNAUTHORIZED      | 401  | 请求要求用户的身份认证。                                     |
+| PAYMENT_REQUIRED  | 402  | 保留，将来使用。                                             |
+| FORBIDDEN         | 403  | 服务器理解请求客户端的请求，但是拒绝执行此请求。             |
+| NOT_FOUND         | 404  | 服务器无法根据客户端的请求找到资源（网页）。                 |
+| BAD_METHOD        | 405  | 客户端请求中的方法被禁止。                                   |
+| NOT_ACCEPTABLE    | 406  | 服务器无法根据客户端请求的内容特性完成请求。                 |
+| PROXY_AUTH        | 407  | 请求要求代理的身份认证。                                     |
+| CLIENT_TIMEOUT    | 408  | 请求时间过长，超时。                                         |
+| CONFLICT          | 409  | 服务器完成客户端的PUT请求是可能返回此代码，服务器处理请求时发生了冲突。 |
+| GONE              | 410  | 客户端请求的资源已经不存在。                                 |
+| LENGTH_REQUIRED   | 411  | 服务器无法处理客户端发送的不带Content-Length的请求信息。     |
+| PRECON_FAILED     | 412  | 客户端请求信息的先决条件错误。                               |
+| ENTITY_TOO_LARGE  | 413  | 由于请求的实体过大，服务器无法处理，因此拒绝请求。           |
+| REQ_TOO_LONG      | 414  | 请求的URI过长（URI通常为网址），服务器无法处理。             |
+| UNSUPPORTED_TYPE  | 415  | 服务器无法处理请求的格式。                                   |
+| INTERNAL_ERROR    | 500  | 服务器内部错误，无法完成请求。                               |
+| NOT_IMPLEMENTED   | 501  | 服务器不支持请求的功能，无法完成请求。                       |
+| BAD_GATEWAY       | 502  | 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 |
+| UNAVAILABLE       | 503  | 由于超载或系统维护，服务器暂时的无法处理客户端的请求。       |
+| GATEWAY_TIMEOUT   | 504  | 充当网关或代理的服务器，未及时从远端服务器获取请求。         |
+| VERSION           | 505  | 服务器请求的HTTP协议的版本。                                 |
+
+## HttpResponse
+
+request方法回调函数的返回值类型。
+
+| 参数名               | 类型                                         | 必填 | 说明                                                         |
+| -------------------- | -------------------------------------------- | ---- | ------------------------------------------------------------ |
+| 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。                                       |
+

zh-cn/application-dev/reference/apis/js-apis-webSocket.md

+# WebSocket连接
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+>
+>当前暂时不支持WebSocket，预计在MR版本支持。
+
+使用WebSocket建立服务器与客户端的双向连接，需要先通过[createWebSocket](#websocketcreatewebsocket)方法创建[WebSocket](#websocket)对象，然后通过[connect](#connect)方法连接到服务器。当连接成功后，客户端会收到[open](#onopen)事件的回调，之后客户端就可以通过[send](#send)方法与服务器进行通信。当服务器发信息给客户端时，客户端会收到[message](#onmessage)事件的回调。当客户端不要此连接时，可以通过调用[close](#close)方法主动断开连接，之后客户端会收到[close](#onclose)事件的回调。
+
+若在上述任一过程中发生错误，客户端会收到[error](#onerror)事件的回调。
+
+
+## 导入模块
+
+```
+import webSocket from '@ohos.net.webSocket';
+```
+
+## 完整示例
+
+```
+import webSocket from '@ohos.net.webSocket';
+
+var defaultIpAddress = "ws://";
+let ws = webSocket.createWebSocket();
+ws.on('open', (err, value) => {
+    console.log("on open, status:" + value.status + ", message:" + value.message);
+    // 当收到on('open')事件时，可以通过send()方法与服务器进行通信
+    ws.send("Hello, server!", (err, value) => {
+        if (!err) {
+            console.log("send success");
+        } else {
+            console.log("send fail, err:" + JSON.stringify(err));
+        }
+    });
+});
+ws.on('message', (err, value) => {
+    console.log("on message, message:" + value);
+    // 当收到服务器的`bye`消息时（此消息字段仅为示意，具体字段需要与服务器协商），主动断开连接
+    if (value === 'bye') {
+        ws.close((err, value) => {
+            if (!err) {
+                console.log("close success");
+            } else {
+                console.log("close fail, err is " + JSON.stringify(err));
+            }
+        });
+    }
+});
+ws.on('close', (err, value) => {
+    console.log("on close, code is " + value.code + ", reason is " + value.reason);
+});
+ws.on('error', (err) => {
+    console.log("on error, error:" + JSON.stringify(err));
+});
+ws.connect(defaultIpAddress, (err, value) => {
+    if (!err) {
+        console.log("connect success");
+    } else {
+        console.log("connect fail, err:" + JSON.stringify(err));
+    }
+});
+```
+
+## webSocket.createWebSocket
+
+createWebSocket\(\): WebSocket
+
+创建一个WebSocket，里面包括建立连接、关闭连接、发送数据和订阅/取消订阅WebSocket连接的打开事件、接收到服务器消息事件、关闭事件和错误事件。
+
+**返回值：**
+
+| 类型                                | 说明                                                         |
+| :---------------------------------- | :----------------------------------------------------------- |
+| [WebSocket](#websocket) | 返回一个WebSocket对象，里面包括connect、send、close、on和off方法。 |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+```
+
+
+## WebSocket
+
+在调用WebSocket的方法前，需要先通过[webSocket.createWebSocket](#webSocketcreatewebsocket)创建一个WebSocket。
+
+### connect
+
+connect\(url: string, callback: AsyncCallback<boolean\>\): void
+
+根据URL地址，建立一个WebSocket连接，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                     | 必填 | 说明                         |
+| -------- | ------------------------ | ---- | ---------------------------- |
+| url      | string                   | 是   | 建立WebSocket连接的URL地址。 |
+| callback | AsyncCallback\<boolean\> | 是   | 回调函数。                   |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.connect(url, (err, value) => {
+	if (!err) {
+		console.log("connect success");
+	} else {
+		console.log("connect fail, err:" + JSON.stringify(err))
+	}
+});
+```
+
+
+### connect
+
+connect\(url: string, options: WebSocketRequestOptions, callback: AsyncCallback<boolean\>\): void
+
+根据URL地址和header，建立一个WebSocket连接，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                     | 必填 | 说明                                                    |
+| -------- | ------------------------ | ---- | ------------------------------------------------------- |
+| url      | string                   | 是   | 建立WebSocket连接的URL地址。                            |
+| options  | WebSocketRequestOptions  | 是   | 参考[WebSocketRequestOptions](#websocketrequestoptions)。 |
+| callback | AsyncCallback\<boolean\> | 是   | 回调函数。                                              |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.connect(url, {
+	header: {
+		"key": "value",
+		"key2": "value2"
+	}
+}, (err, value) => {
+	if (!err) {
+		console.log("connect success");
+	} else {
+		console.log("connect fail, err:" + JSON.stringify(err))
+	}
+});
+```
+
+
+### connect
+
+connect\(url: string, options?: WebSocketRequestOptions\): Promise<boolean\>
+
+根据URL地址和header，建立一个WebSocket连接，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名  | 类型                    | 必填 | 说明                                                    |
+| ------- | ----------------------- | ---- | ------------------------------------------------------- |
+| url     | string                  | 是   | 建立WebSocket连接的URL地址。                            |
+| options | WebSocketRequestOptions | 否   | 参考[WebSocketRequestOptions](#websocketrequestoptions)。 |
+
+**返回值：**
+
+| 类型               | 说明                              |
+| :----------------- | :-------------------------------- |
+| Promise\<boolean\> | 以Promise形式返回建立连接的结果。 |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+let promise = ws.connect(url);
+promise.then((value) => {
+	console.log("connect success")
+}).catch((err) => {
+	console.log("connect fail, error:" + JSON.stringify(err))
+});
+```
+
+
+### send
+
+send\(data: string | ArrayBuffer, callback: AsyncCallback<boolean\>\): void
+
+通过WebSocket连接发送数据，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                     | 必填 | 说明         |
+| -------- | ------------------------ | ---- | ------------ |
+| data     | string \| ArrayBuffer <sup>8+</sup> | 是   | 发送的数据。 |
+| callback | AsyncCallback\<boolean\> | 是   | 回调函数。   |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.connect(url, (err, value) => {
+	ws.send("Hello, server!", (err, value) => {
+		if (!err) {
+			console.log("send success");
+		} else {
+			console.log("send fail, err:" + JSON.stringify(err))
+		}
+	});
+});
+```
+
+
+### send
+
+send\(data: string | ArrayBuffer\): Promise<boolean\>
+
+通过WebSocket连接发送数据，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名 | 类型   | 必填 | 说明         |
+| ------ | ------ | ---- | ------------ |
+| data     | string \| ArrayBuffer <sup>8+</sup> | 是   | 发送的数据。 |
+
+**返回值：**
+
+| 类型               | 说明                              |
+| :----------------- | :-------------------------------- |
+| Promise\<boolean\> | 以Promise形式返回发送数据的结果。 |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.connect(url, (err, value) => {
+	let promise = ws.send("Hello, server!");
+	promise.then((value) => {
+		console.log("send success")
+	}).catch((err) => {
+		console.log("send fail, error:" + JSON.stringify(err))
+	});
+});
+```
+
+
+### close
+
+close\(callback: AsyncCallback<boolean\>\): void
+
+关闭WebSocket连接，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                     | 必填 | 说明       |
+| -------- | ------------------------ | ---- | ---------- |
+| callback | AsyncCallback\<boolean\> | 是   | 回调函数。 |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.close((err, value) => {
+	if (!err) {
+		console.log("close success")
+	} else {
+		console.log("close fail, err is " + JSON.stringify(err))
+	}
+});
+```
+
+
+### close
+
+close\(options: WebSocketCloseOptions, callback: AsyncCallback<boolean\>\): void
+
+根据可选参数code和reason，关闭WebSocket连接，使用callback方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名   | 类型                     | 必填 | 说明                                                  |
+| -------- | ------------------------ | ---- | ----------------------------------------------------- |
+| options  | WebSocketCloseOptions    | 是   | 参考[WebSocketCloseOptions](#websocketcloseoptions)。 |
+| callback | AsyncCallback\<boolean\> | 是   | 回调函数。                                            |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+ws.close({
+	code: 1000,
+	reason: "your reason"
+}, (err, value) => {
+	if (!err) {
+		console.log("close success")
+	} else {
+		console.log("close fail, err is " + JSON.stringify(err))
+	}
+});
+```
+
+
+### close
+
+close\(options?: WebSocketCloseOptions\): Promise<boolean\>
+
+根据可选参数code和reason，关闭WebSocket连接，使用Promise方式作为异步方法。
+
+**需要权限**：ohos.permission.INTERNET
+
+**参数：**
+
+| 参数名  | 类型                  | 必填 | 说明                                                  |
+| ------- | --------------------- | ---- | ----------------------------------------------------- |
+| options | WebSocketCloseOptions | 否   | 参考[WebSocketCloseOptions](#websocketcloseoptions)。 |
+
+**返回值：**
+
+| 类型               | 说明                              |
+| :----------------- | :-------------------------------- |
+| Promise\<boolean\> | 以Promise形式返回关闭连接的结果。 |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let url = "ws://"
+let promise = ws.close({
+	code: 1000,
+	reason: "your reason"
+});
+promise.then((value) => {
+	console.log("close success")
+}).catch((err) => {
+	console.log("close fail, err is " + JSON.stringify(err))
+});
+```
+
+
+### on\('open'\)
+
+on\(type: 'open', callback: AsyncCallback<Object\>\): void
+
+订阅WebSocket的打开事件，使用callback方式作为异步方法。
+
+**参数：**
+
+| 参数名   | 类型                    | 必填 | 说明                          |
+| -------- | ----------------------- | ---- | ----------------------------- |
+| type     | string                  | 是   | 'open'：WebSocket的打开事件。 |
+| callback | AsyncCallback\<Object\> | 是   | 回调函数。                    |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.on('open', (err, value) => {
+	console.log("on open, status:" + value.status + ", message:" + value.message);
+});
+```
+
+
+### off\('open'\)
+
+off\(type: 'open', callback?: AsyncCallback<Object\>\): void
+
+取消订阅WebSocket的打开事件，使用callback方式作为异步方法。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型                    | 必填 | 说明                          |
+| -------- | ----------------------- | ---- | ----------------------------- |
+| type     | string                  | 是   | 'open'：WebSocket的打开事件。 |
+| callback | AsyncCallback\<Object\> | 否   | 回调函数。                    |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+let callback1 = (err, value) => {
+	console.log("on open, status:" + value.status + ", message:" + value.message);
+}
+ws.on('open', callback1);
+// 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅
+ws.off('open', callback1);
+```
+
+
+### on\('message'\)
+
+on\(type: 'message', callback: AsyncCallback<string | ArrayBuffer\>\): void
+
+订阅WebSocket的接收到服务器消息事件，使用callback方式作为异步方法。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
+
+**参数：**
+
+| 参数名   | 类型                    | 必填 | 说明                                         |
+| -------- | ----------------------- | ---- | -------------------------------------------- |
+| type     | string                  | 是   | 'message'：WebSocket的接收到服务器消息事件。 |
+| callback | AsyncCallback\<string \| ArrayBuffer <sup>8+</sup>\> | 是   | 回调函数。                                   |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.on('message', (err, value) => {
+	console.log("on message, message:" + value);
+});
+```
+
+
+### off\('message'\)
+
+off\(type: 'message', callback?: AsyncCallback<string | ArrayBuffer\>\): void
+
+取消订阅WebSocket的接收到服务器消息事件，使用callback方式作为异步方法。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>AsyncCallback中的数据可以是字符串\(API 6\)或ArrayBuffer\(API 8\)。
+>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型                                                | 必填 | 说明                                         |
+| -------- | --------------------------------------------------- | ---- | -------------------------------------------- |
+| type     | string                                              | 是   | 'message'：WebSocket的接收到服务器消息事件。 |
+| callback | AsyncCallback\<string \|ArrayBuffer <sup>8+</sup>\> | 否   | 回调函数。                                   |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.off('message');
+```
+
+
+### on\('close'\)
+
+on\(type: 'close', callback: AsyncCallback<\{ code: number, reason: string \}\>\): void
+
+订阅WebSocket的关闭事件，使用callback方式作为异步方法。
+
+**参数：**
+
+| 参数名   | 类型                                            | 必填 | 说明                           |
+| -------- | ----------------------------------------------- | ---- | ------------------------------ |
+| type     | string                                          | 是   | 'close'：WebSocket的关闭事件。 |
+| callback | AsyncCallback<{ code: number, reason: string }> | 是   | 回调函数。                     |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.on('close', (err, value) => {
+	console.log("on close, code is " + value.code + ", reason is " + value.reason);
+});
+```
+
+
+### off\('close'\)
+
+off\(type: 'close', callback?: AsyncCallback<\{ code: number, reason: string \}\>\): void
+
+取消订阅WebSocket的关闭事件，使用callback方式作为异步方法。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型                                            | 必填 | 说明                           |
+| -------- | ----------------------------------------------- | ---- | ------------------------------ |
+| type     | string                                          | 是   | 'close'：WebSocket的关闭事件。 |
+| callback | AsyncCallback<{ code: number, reason: string }> | 否   | 回调函数。                     |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.off('close');
+```
+
+
+### on\('error'\)
+
+on\(type: 'error', callback: ErrorCallback\): void
+
+订阅WebSocket的Error事件，使用callback方式作为异步方法。
+
+**参数：**
+
+| 参数名   | 类型          | 必填 | 说明                            |
+| -------- | ------------- | ---- | ------------------------------- |
+| type     | string        | 是   | 'error'：WebSocket的Error事件。 |
+| callback | ErrorCallback | 是   | 回调函数。                      |
+
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.on('error', (err) => {
+	console.log("on error, error:" + JSON.stringify(err))
+});
+```
+
+
+### off\('error'\)
+
+off\(type: 'error', callback?: ErrorCallback\): void
+
+取消订阅WebSocket的Error事件，使用callback方式作为异步方法。
+
+>![](public_sys-resources/icon-note.gif) **说明：** 
+>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+
+**参数：**
+
+| 参数名   | 类型          | 必填 | 说明                            |
+| -------- | ------------- | ---- | ------------------------------- |
+| type     | string        | 是   | 'error'：WebSocket的Error事件。 |
+| callback | ErrorCallback | 否   | 回调函数。                      |
+
+**示例：**
+
+```
+let ws = webSocket.createWebSocket();
+ws.off('error');
+```
+
+
+## WebSocketRequestOptions
+
+建立WebSocket连接时，可选参数的类型和说明。
+
+| 参数名 | 类型   | 必填 | 说明                                                         |
+| ------ | ------ | ---- | ------------------------------------------------------------ |
+| header | Object | 否   | 建立WebSocket连接可选参数，代表建立连接时携带的HTTP头信息。参数内容自定义，也可以不指定。 |
+
+
+## WebSocketCloseOptions
+
+关闭WebSocket连接时，可选参数的类型和说明。
+
+| 参数名 | 类型   | 必填 | 说明                                                         |
+| ------ | ------ | ---- | ------------------------------------------------------------ |
+| code   | number | 否   | 错误码，关闭WebSocket连接时的可选参数，可根据实际情况来填。默认值为1000。 |
+| reason | string | 否   | 原因值，关闭WebSocket连接时的可选参数，可根据实际情况来填。默认值为空字符串（""）。 |
+
+## close错误码说明
+
+发送给服务端的错误码可以自行定义，下面的列表仅供参考。
+
+| 值        | 说明               |
+| :-------- | :----------------- |
+| 1000      | 正常关闭           |
+| 1001      | 服务器主动关闭     |
+| 1002      | 协议错误           |
+| 1003      | 无法处理的数据类型 |
+| 1004~1015 | 保留值             |
+