Docs Update

Signed-off-by: NYangys <yangyousheng@huawei.com>

.idea/.gitignore

+# Default ignored files
+/shelf/
+/workspace.xml
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml
+# Editor-based HTTP Client requests
+/httpRequests/

.idea/deployment.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PublishConfigData" remoteFilesAllowedToDisappearOnAutoupload="false">
+    <serverData>
+      <paths name="Remote Host (21773fe5-3a8b-4714-ba79-172b30f06462)">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="Remote Host (83bee4b2-4ac6-41d9-9e77-7deb46a7cb1c)">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+    </serverData>
+  </component>
+</project>
\ No newline at end of file

.idea/docs.iml

+<?xml version="1.0" encoding="UTF-8"?>
+<module type="CPP_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
\ No newline at end of file

.idea/modules.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/docs.iml" filepath="$PROJECT_DIR$/.idea/docs.iml" />
+    </modules>
+  </component>
+</project>
\ No newline at end of file

.idea/vcs.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
\ No newline at end of file

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

@@ -518,7 +518,7 @@ request2(url: string, options? : HttpRequestOptions): Promise\<number\>
 **示例：**
 
 ```js
-let promise = httpRequest.request("EXAMPLE_URL", {
+let promise = httpRequest.request2("EXAMPLE_URL", {
     method: http.RequestMethod.GET,
     connectTimeout: 60000,
     readTimeout: 60000,
@@ -720,8 +720,8 @@ on(type: 'dataEnd', callback: Callback\<void\>): void
 **示例：**
 
 ```js
-httpRequest.on('dataReceive', () => {
-    console.info('Receive dataEnd！');
+httpRequest.on('dataEnd', () => {
+    console.info('Receive dataEnd !');
 });
 ```
 
@@ -751,7 +751,7 @@ httpRequest.off('dataEnd');
 
 ### on('dataProgress')<sup>10+</sup>
 
- on(type: 'dataProgress', callback: Callback\<{ receiveSize: number, totalSize: number }\>): void
+ on(type: 'dataProgress', callback: AsyncCallback\<{ receiveSize: number, totalSize: number }\>): void
 
 订阅HTTP流式响应数据接收进度事件。
 
@@ -886,7 +886,7 @@ request方法回调函数的返回值类型。
 | result               | string \| Object \| ArrayBuffer<sup>6+</sup> | 是   | HTTP请求根据响应头中Content-type类型返回对应的响应格式内容：<br />- application/json：返回JSON格式的字符串，如需HTTP响应具体内容，需开发者自行解析<br />- application/octet-stream：ArrayBuffer<br />- 其他：string |
 | resultType<sup>9+</sup> | [HttpDataType](#httpdatatype9)             | 是   | 返回值类型。                           |
 | responseCode         | [ResponseCode](#responsecode) \| number      | 是   | 回调函数执行成功时，此字段为[ResponseCode](#responsecode)。若执行失败，错误码将会从AsyncCallback中的err字段返回。 |
-| 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']； |
+| 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> | string                                       | 是   | 服务器返回的 cookies。                                       |
 
 ## http.createHttpResponseCache<sup>9+</sup>

zh-cn/application-dev/reference/apis/js-apis-net-connection.md

@@ -34,10 +34,10 @@ createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnectio
 **示例：**
 
 ```js
-// 关注默认网络
+// 关注默认网络, 不需要传参
 let netConnection = connection.createNetConnection()
 
-// 关注蜂窝网络
+// 关注蜂窝网络，需要传入相关网络特征，timeout参数未传入说明未使用超时时间，此时timeout为0
 let netConnectionCellular = connection.createNetConnection({
     netCapabilities: {
         bearerTypes: [connection.NetBearType.BEARER_CELLULAR]
@@ -166,7 +166,7 @@ getGlobalHttpProxy(callback: AsyncCallback\<HttpProxy>): void
 **示例：**
 
 ```js
-connection.getGlobalHttpProxy((error,data) => {
+connection.getGlobalHttpProxy((error, data) => {
     console.info(JSON.stringify(error));
     console.info(JSON.stringify(data));
 })
@@ -237,16 +237,15 @@ setGlobalHttpProxy(httpProxy: HttpProxy, callback: AsyncCallback\<void>): void
 **示例：**
 
 ```js
-let exclusionStr="192.168,baidu.com"
+let exclusionStr = "192.168,baidu.com"
 let exclusionArray = exclusionStr.split(',');
 let httpProxy = {
     host: "192.168.xx.xxx",
     port: 8080,
     exclusionList: exclusionArray
 }
-connection.setGlobalHttpProxy(httpProxy, (error, data) => {
+connection.setGlobalHttpProxy(httpProxy, (error) => {
     console.info(JSON.stringify(error));
-   console.info(JSON.stringify(data));
 });
 ```
 
@@ -287,7 +286,7 @@ setGlobalHttpProxy(httpProxy: HttpProxy): Promise\<void>;
 **示例：**
 
 ```js
-let exclusionStr="192.168,baidu.com"
+let exclusionStr = "192.168,baidu.com"
 let exclusionArray = exclusionStr.split(',');
 let httpProxy = {
     host: "192.168.xx.xxx",
@@ -296,7 +295,7 @@ let httpProxy = {
 }
 connection.setGlobalHttpProxy(httpProxy).then(() => {
     console.info("success");
-}).catch(error=>{
+}).catch(error => {
     console.info(JSON.stringify(error));
 })
 ```
@@ -325,7 +324,7 @@ getAppNet(callback: AsyncCallback\<NetHandle>): void
 **示例：**
 
 ```js
-connection.getAppNet(function(error, data) {
+connection.getAppNet(function (error, data) {
     console.log(JSON.stringify(error))
     console.log(JSON.stringify(data))
 })
@@ -935,8 +934,7 @@ connection.disableAirplaneMode().then(function (error) {
 
 reportNetConnected(netHandle: NetHandle, callback: AsyncCallback&lt;void&gt;): void
 
-向网络管理报告网络处于可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。
-使用callback方式作为异步方法。
+向网络管理报告网络处于可用状态，使用callback方式作为异步方法。
 
 **需要权限**：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET
 
@@ -973,8 +971,7 @@ connection.getDefaultNet().then(function (netHandle) {
 
 reportNetConnected(netHandle: NetHandle): Promise&lt;void&gt;
 
-向网络管理报告网络处于可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。
-使用Promise方式作为异步方法。
+向网络管理报告网络处于可用状态，使用Promise方式作为异步方法。
 
 **需要权限**：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET
 
@@ -1524,6 +1521,7 @@ connection.getDefaultNet().then((netHandle) => {
         }, error => {
             if (error) {
                 console.log('bind fail');
+                return;
             }
             netHandle.bindSocket(tcp, (error, data) => {
                 if (error) {
@@ -1543,6 +1541,7 @@ connection.getDefaultNet().then((netHandle) => {
         }, error => {
             if (error) {
                 console.log('bind fail');
+                return;
             }
             udp.on('message', (data) => {
                 console.log(JSON.stringify(data))
@@ -1602,6 +1601,7 @@ connection.getDefaultNet().then((netHandle) => {
         }, error => {
             if (error) {
                 console.log('bind fail');
+                return;
             }
             netHandle.bindSocket(tcp).then((data) => {
                 console.log(JSON.stringify(data));
@@ -1619,6 +1619,7 @@ connection.getDefaultNet().then((netHandle) => {
         }, error => {
             if (error) {
                 console.log('bind fail');
+                return;
             }
             udp.on('message', (data) => {
                 console.log(JSON.stringify(data));

zh-cn/application-dev/reference/apis/js-apis-net-mdns.md

@@ -358,7 +358,7 @@ let localServiceInfo = {
     }]
 }
 
-mdns.resolveLocalService(context, localServiceInfo).then(function (data){
+mdns.resolveLocalService(context, localServiceInfo).then(function (data) {
     console.log(JSON.stringify(data));
 })
 ```

zh-cn/application-dev/reference/apis/js-apis-net-sharing.md

@@ -194,7 +194,7 @@ startSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.startSharing(SHARING_WIFI, (error) => {
     console.log(JSON.stringify(error));
 });
@@ -243,7 +243,7 @@ startSharing(type: SharingIfaceType): Promise\<void>
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.startSharing(SHARING_WIFI).then(() => {
     console.log("start wifi sharing successful");
 }).catch(error => {
@@ -287,7 +287,7 @@ stopSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.stopSharing(SHARING_WIFI, (error) => {
     console.log(JSON.stringify(error));
 });
@@ -334,7 +334,7 @@ stopSharing(type: SharingIfaceType): Promise\<void>
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.stopSharing(SHARING_WIFI).then(() => {
     console.log("stop wifi sharing successful");
 }).catch(error => {
@@ -588,7 +588,7 @@ getSharingIfaces(state: SharingIfaceState, callback: AsyncCallback\<Array\<strin
 
 ```js
 import SharingIfaceState from '@ohos.net.sharing'
-let SHARING_BLUETOOTH=2;
+let SHARING_BLUETOOTH = 2;
 sharing.getSharingIfaces(SHARING_BLUETOOTH, (error, data) => {
     console.log(JSON.stringify(error));
     console.log(JSON.stringify(data));
@@ -633,7 +633,7 @@ getSharingIfaces(state: SharingIfaceState): Promise\<Array\<string>>
 
 ```js
 import SharingIfaceState from '@ohos.net.sharing'
-let SHARING_BLUETOOTH=2;
+let SHARING_BLUETOOTH = 2;
 sharing.getSharingIfaces(SHARING_BLUETOOTH).then(data => {
     console.log(JSON.stringify(data));
 }).catch(error => {
@@ -674,7 +674,7 @@ getSharingState(type: SharingIfaceType, callback: AsyncCallback\<SharingIfaceSta
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.getSharingState(SHARING_WIFI, (error, data) => {
     console.log(JSON.stringify(error));
     console.log(JSON.stringify(data));
@@ -719,7 +719,7 @@ getSharingState(type: SharingIfaceType): Promise\<SharingIfaceState>
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.getSharingState(SHARING_WIFI).then(data => {
     console.log(JSON.stringify(data));
 }).catch(error => {
@@ -760,7 +760,7 @@ getSharableRegexes(type: SharingIfaceType, callback: AsyncCallback\<Array\<strin
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.getSharableRegexes(SHARING_WIFI, (error, data) => {
     console.log(JSON.stringify(error));
     console.log(JSON.stringify(data));
@@ -805,7 +805,7 @@ getSharableRegexes(type: SharingIfaceType): Promise\<Array\<string>>
 
 ```js
 import SharingIfaceType from '@ohos.net.sharing'
-let SHARING_WIFI=0;
+let SHARING_WIFI = 0;
 sharing.getSharableRegexes(SHARING_WIFI).then(data => {
     console.log(JSON.stringify(data));
 }).catch(error => {
@@ -842,8 +842,8 @@ on(type: 'sharingStateChange', callback: Callback\<boolean>): void
 **示例：**
 
 ```js
-   sharing.on('sharingStateChange', (data) => {
-    console.log('on sharingStateChange：' + JSON.stringify(data));
+sharing.on('sharingStateChange', (data) => {
+    console.log('on sharingStateChange: ' + JSON.stringify(data));
 });
 ```
 
@@ -910,8 +910,8 @@ on(type: 'interfaceSharingStateChange', callback: Callback\<{ type: SharingIface
 **示例：**
 
 ```js
- sharing.on('interfaceSharingStateChange', (data) => {
-    console.log('on interfaceSharingStateChange：' + JSON.stringify(data));
+sharing.on('interfaceSharingStateChange', (data) => {
+    console.log('on interfaceSharingStateChange:' + JSON.stringify(data));
 });
 ```
 
@@ -978,8 +978,8 @@ on(type: 'sharingUpstreamChange', callback: Callback\<NetHandle>): void
 **示例：**
 
 ```js
-  sharing.on('sharingUpstreamChange', (data) => {
-    console.log('on sharingUpstreamChange：' + JSON.stringify(data));
+sharing.on('sharingUpstreamChange', (data) => {
+    console.log('on sharingUpstreamChange:' + JSON.stringify(data));
 });
 ```
 

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

@@ -26,14 +26,12 @@ constructUDPSocketInstance(): UDPSocket
 | :--------------------------------- | :---------------------- |
 | [UDPSocket](#udpsocket) | 返回一个UDPSocket对象。 |
 
-
 **示例：**
 
 ```js
 let udp = socket.constructUDPSocketInstance();
 ```
 
-
 ## UDPSocket
 
 UDPSocket连接。在调用UDPSocket的方法前，需要先通过[socket.constructUDPSocketInstance](#socketconstructudpsocketinstance)创建UDPSocket对象。
@@ -75,7 +73,6 @@ udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
 })
 ```
 
-
 ### bind
 
 bind(address: NetAddress): Promise\<void\>
@@ -110,14 +107,13 @@ bind(address: NetAddress): Promise\<void\>
 ```js
 let udp = socket.constructUDPSocketInstance();
 let promise = udp.bind({address: '192.168.xx.xxx', port: 8080, family: 1});
-promise .then(() => {
+promise.then(() => {
     console.log('bind success');
 }).catch(err => {
     console.log('bind fail');
 });
 ```
 
-
 ### send
 
 send(options: UDPSendOptions, callback: AsyncCallback\<void\>): void
@@ -149,13 +145,13 @@ send(options: UDPSendOptions, callback: AsyncCallback\<void\>): void
 ```js
 let udp = socket.constructUDPSocketInstance();
 udp.send({
-  data:'Hello, server!',
+    data: 'Hello, server!',
     address: {
-	address:'192.168.xx.xxx',
-	port:xxxx,
-	family:1
+        address: '192.168.xx.xxx',
+        port: xxxx,
+        family: 1
     }
-}, err=> {
+}, err => {
     if (err) {
         console.log('send fail');
         return;
@@ -164,7 +160,6 @@ udp.send({
 })
 ```
 
-
 ### send
 
 send(options: UDPSendOptions): Promise\<void\>
@@ -201,11 +196,11 @@ send(options: UDPSendOptions): Promise\<void\>
 ```js
 let udp = socket.constructUDPSocketInstance();
 let promise = udp.send({
-  data:'Hello, server!',
+    data: 'Hello, server!',
     address: {
-	address:'192.168.xx.xxx',
-	port:xxxx,
-	family:1
+        address: '192.168.xx.xxx',
+        port: xxxx,
+        family: 1
     }
 });
 promise.then(() => {
@@ -215,7 +210,6 @@ promise.then(() => {
 });
 ```
 
-
 ### close
 
 close(callback: AsyncCallback\<void\>): void
@@ -245,7 +239,6 @@ udp.close(err => {
 })
 ```
 
-
 ### close
 
 close(): Promise\<void\>
@@ -274,15 +267,14 @@ promise.then(() => {
 });
 ```
 
-
 ### getState
 
 getState(callback: AsyncCallback\<SocketStateBase\>): void
 
 获取UDPSocket状态。使用callback方式作为异步方法。
 
->**说明：** 
->bind方法调用成功后，才可调用此方法。
+> **说明：**
+> bind方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -320,15 +312,14 @@ udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
 })
 ```
 
-
 ### getState
 
 getState(): Promise\<SocketStateBase\>
 
 获取UDPSocket状态。使用Promise方式作为异步方法。
 
->**说明：** 
->bind方法调用成功后，才可调用此方法。
+> **说明：**
+> bind方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -344,7 +335,8 @@ getState(): Promise\<SocketStateBase\>
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
+let promise = udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1});
+promise.then(err => {
     if (err) {
         console.log('bind fail');
         return;
@@ -356,18 +348,17 @@ udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
     }).catch(err => {
         console.log('getState fail');
     });
-})
+});
 ```
 
-
 ### setExtraOptions
 
 setExtraOptions(options: UDPExtraOptions, callback: AsyncCallback\<void\>): void
 
 设置UDPSocket连接的其他属性。使用callback方式作为异步方法。
 
->**说明：** 
->bind方法调用成功后，才可调用此方法。
+> **说明：**
+> bind方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -391,19 +382,19 @@ setExtraOptions(options: UDPExtraOptions, callback: AsyncCallback\<void\>): void
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-udp.bind({address:'192.168.xx.xxx', port:xxxx, family:1}, err=> {
+udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
     if (err) {
         console.log('bind fail');
         return;
     }
     console.log('bind success');
     udp.setExtraOptions({
-	receiveBufferSize:1000,
-	sendBufferSize:1000,
-	reuseAddress:false,
-	socketTimeout:6000,
-	broadcast:true
-  }, err=> {
+        receiveBufferSize: 1000,
+        sendBufferSize: 1000,
+        reuseAddress: false,
+        socketTimeout: 6000,
+        broadcast: true
+    }, err => {
         if (err) {
             console.log('setExtraOptions fail');
             return;
@@ -413,15 +404,14 @@ udp.bind({address:'192.168.xx.xxx', port:xxxx, family:1}, err=> {
 })
 ```
 
-
 ### setExtraOptions
 
 setExtraOptions(options: UDPExtraOptions): Promise\<void\>
 
 设置UDPSocket连接的其他属性。使用Promise方式作为异步方法。
 
->**说明：** 
->bind方法调用成功后，才可调用此方法。
+> **说明：**
+> bind方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -450,15 +440,15 @@ setExtraOptions(options: UDPExtraOptions): Promise\<void\>
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-let promise = udp.bind({address:'192.168.xx.xxx', port:xxxx, family:1});
+let promise = udp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1});
 promise.then(() => {
     console.log('bind success');
     let promise1 = udp.setExtraOptions({
-	receiveBufferSize:1000,
-	sendBufferSize:1000,
-	reuseAddress:false,
-	socketTimeout:6000,
-	broadcast:true
+        receiveBufferSize: 1000,
+        sendBufferSize: 1000,
+        reuseAddress: false,
+        socketTimeout: 6000,
+        broadcast: true
     });
     promise1.then(() => {
         console.log('setExtraOptions success');
@@ -470,7 +460,6 @@ promise.then(() => {
 });
 ```
 
-
 ### on('message')
 
 on(type: 'message', callback: Callback\<{message: ArrayBuffer, remoteInfo: SocketRemoteInfo}\>): void
@@ -495,15 +484,14 @@ udp.on('message', value => {
 });
 ```
 
-
 ### off('message')
 
 off(type: 'message', callback?: Callback\<{message: ArrayBuffer, remoteInfo: SocketRemoteInfo}\>): void
 
 取消订阅UDPSocket连接的接收消息事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -518,7 +506,7 @@ off(type: 'message', callback?: Callback\<{message: ArrayBuffer, remoteInfo: Soc
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-let callback = value =>{
+let callback = value => {
     console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
 }
 udp.on('message', callback);
@@ -527,7 +515,6 @@ udp.off('message', callback);
 udp.off('message');
 ```
 
-
 ### on('listening' | 'close')
 
 on(type: 'listening' | 'close', callback: Callback\<void\>): void
@@ -551,19 +538,18 @@ udp.on('listening', () => {
     console.log("on listening success");
 });
 udp.on('close', () => {
-	console.log("on close success" );
+    console.log("on close success");
 });
 ```
 
-
 ### off('listening' | 'close')
 
 off(type: 'listening' | 'close', callback?: Callback\<void\>): void
 
 取消订阅UDPSocket连接的数据包消息事件或关闭事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -578,14 +564,14 @@ off(type: 'listening' | 'close', callback?: Callback\<void\>): void
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-let callback1 = () =>{
+let callback1 = () => {
     console.log("on listening, success");
 }
 udp.on('listening', callback1);
 // 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 udp.off('listening', callback1);
 udp.off('listening');
-let callback2 = () =>{
+let callback2 = () => {
     console.log("on close, success");
 }
 udp.on('close', callback2);
@@ -594,7 +580,6 @@ udp.off('close', callback2);
 udp.off('close');
 ```
 
-
 ### on('error')
 
 on(type: 'error', callback: ErrorCallback): void
@@ -619,15 +604,14 @@ udp.on('error', err => {
 });
 ```
 
-
 ### off('error')
 
 off(type: 'error', callback?: ErrorCallback): void
 
 取消订阅UDPSocket连接的error事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -642,7 +626,7 @@ off(type: 'error', callback?: ErrorCallback): void
 
 ```js
 let udp = socket.constructUDPSocketInstance();
-let callback = err =>{
+let callback = err => {
     console.log("on error, err:" + JSON.stringify(err));
 }
 udp.on('error', callback);
@@ -651,7 +635,6 @@ udp.off('error', callback);
 udp.off('error');
 ```
 
-
 ## NetAddress
 
 目标地址信息。
@@ -730,9 +713,9 @@ constructTCPSocketInstance(): TCPSocket
 
 **返回值：**
 
-  | 类型                               | 说明                    |
+| 类型                               | 说明                    |
   | :--------------------------------- | :---------------------- |
-  | [TCPSocket](#tcpsocket) | 返回一个TCPSocket对象。 |
+| [TCPSocket](#tcpsocket) | 返回一个TCPSocket对象。 |
 
 **示例：**
 
@@ -740,7 +723,6 @@ constructTCPSocketInstance(): TCPSocket
 let tcp = socket.constructTCPSocketInstance();
 ```
 
-
 ## TCPSocket
 
 TCPSocket连接。在调用TCPSocket的方法前，需要先通过[socket.constructTCPSocketInstance](#socketconstructtcpsocketinstance)创建TCPSocket对象。
@@ -782,7 +764,6 @@ tcp.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
 })
 ```
 
-
 ### bind
 
 bind(address: NetAddress): Promise\<void\>
@@ -824,15 +805,14 @@ promise.then(() => {
 });
 ```
 
-
 ### connect
 
 connect(options: TCPConnectOptions, callback: AsyncCallback\<void\>): void
 
 连接到指定的IP地址和端口。使用callback方法作为异步方法。
 
->**说明：** 
->bind方法调用成功后，才可调用此方法。
+> **说明：**
+> bind方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -856,7 +836,7 @@ connect(options: TCPConnectOptions, callback: AsyncCallback\<void\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000}, err => {
+tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000}, err => {
     if (err) {
         console.log('connect fail');
         return;
@@ -865,7 +845,6 @@ tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , time
 })
 ```
 
-
 ### connect
 
 connect(options: TCPConnectOptions): Promise\<void\>
@@ -899,7 +878,7 @@ connect(options: TCPConnectOptions): Promise\<void\>
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
+let promise = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000});
 promise.then(() => {
     console.log('connect success')
 }).catch(err => {
@@ -907,15 +886,14 @@ promise.then(() => {
 });
 ```
 
-
 ### send
 
 send(options: TCPSendOptions, callback: AsyncCallback\<void\>): void
 
 通过TCPSocket连接发送数据。使用callback方式作为异步方法。
 
->**说明：** 
->connect方法调用成功后，才可调用此方法。
+> **说明：**
+> connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -939,32 +917,29 @@ send(options: TCPSendOptions, callback: AsyncCallback\<void\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
-promise.then(() => {
+tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000}, () => {
     console.log('connect success');
     tcp.send({
-	data:'Hello, server!'
-  },err => {
+        data: 'Hello, server!'
+        //此处省略encoding， 默认为utf-8编码格式
+    }, err => {
         if (err) {
             console.log('send fail');
             return;
         }
         console.log('send success');
     })
-}).catch(err => {
-  console.log('connect fail');
-});
+})
 ```
 
-
 ### send
 
 send(options: TCPSendOptions): Promise\<void\>
 
 通过TCPSocket连接发送数据。使用Promise方式作为异步方法。
 
->**说明：** 
->connect方法调用成功后，才可调用此方法。
+> **说明：**
+> connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -993,11 +968,11 @@ send(options: TCPSendOptions): Promise\<void\>
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise1 = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
+let promise1 = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000});
 promise1.then(() => {
     console.log('connect success');
     let promise2 = tcp.send({
-	data:'Hello, server!'
+        data: 'Hello, server!'
     });
     promise2.then(() => {
         console.log('send success');
@@ -1009,7 +984,6 @@ promise1.then(() => {
 });
 ```
 
-
 ### close
 
 close(callback: AsyncCallback\<void\>): void
@@ -1045,7 +1019,6 @@ tcp.close(err => {
 })
 ```
 
-
 ### close
 
 close(): Promise\<void\>
@@ -1080,15 +1053,14 @@ promise.then(() => {
 });
 ```
 
-
 ### getRemoteAddress
 
 getRemoteAddress(callback: AsyncCallback\<NetAddress\>): void
 
 获取对端Socket地址。使用callback方式作为异步方法。
 
->**说明：** 
->connect方法调用成功后，才可调用此方法。
+> **说明：**
+> connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1110,8 +1082,7 @@ getRemoteAddress(callback: AsyncCallback\<NetAddress\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
-promise.then(() => {
+tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000}, () => {
     console.log('connect success');
     tcp.getRemoteAddress((err, data) => {
         if (err) {
@@ -1120,20 +1091,17 @@ promise.then(() => {
         }
         console.log('getRemoteAddresssuccess:' + JSON.stringify(data));
     })
-}).catch(err => {
-  console.log('connect fail');
 });
 ```
 
-
 ### getRemoteAddress
 
 getRemoteAddress(): Promise\<NetAddress\>
 
 获取对端Socket地址。使用Promise方式作为异步方法。
 
->**说明：** 
->connect方法调用成功后，才可调用此方法。
+> **说明：**
+> connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1155,7 +1123,7 @@ getRemoteAddress(): Promise\<NetAddress\>
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise1 = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
+let promise1 = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000});
 promise1.then(() => {
     console.log('connect success');
     let promise2 = tcp.getRemoteAddress();
@@ -1169,15 +1137,14 @@ promise1.then(() => {
 });
 ```
 
-
 ### getState
 
 getState(callback: AsyncCallback\<SocketStateBase\>): void
 
 获取TCPSocket状态。使用callback方式作为异步方法。
 
->**说明：** 
->bind或connect方法调用成功后，才可调用此方法。
+> **说明：**
+> bind或connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1199,8 +1166,7 @@ getState(callback: AsyncCallback\<SocketStateBase\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
-promise.then(() => {
+let promise = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000}, () => {
     console.log('connect success');
     tcp.getState((err, data) => {
         if (err) {
@@ -1209,20 +1175,17 @@ promise.then(() => {
         }
         console.log('getState success:' + JSON.stringify(data));
     });
-}).catch(err => {
-  console.log('connect fail');
 });
 ```
 
-
 ### getState
 
 getState(): Promise\<SocketStateBase\>
 
 获取TCPSocket状态。使用Promise方式作为异步方法。
 
->**说明：** 
->bind或connect方法调用成功后，才可调用此方法。
+> **说明：**
+> bind或connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1244,7 +1207,7 @@ getState(): Promise\<SocketStateBase\>
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
+let promise = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000});
 promise.then(() => {
     console.log('connect success');
     let promise1 = tcp.getState();
@@ -1258,15 +1221,14 @@ promise.then(() => {
 });
 ```
 
-
 ### setExtraOptions
 
 setExtraOptions(options: TCPExtraOptions, callback: AsyncCallback\<void\>): void
 
 设置TCPSocket连接的其他属性。使用callback方式作为异步方法。
 
->**说明：** 
->bind或connect方法调用成功后，才可调用此方法。
+> **说明：**
+> bind或connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1290,39 +1252,35 @@ setExtraOptions(options: TCPExtraOptions, callback: AsyncCallback\<void\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
-promise.then(() => {
+let promise = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000}, () => {
     console.log('connect success');
     tcp.setExtraOptions({
         keepAlive: true,
         OOBInline: true,
         TCPNoDelay: true,
-	socketLinger: { on:true, linger:10 },
+        socketLinger: {on: true, linger: 10},
         receiveBufferSize: 1000,
         sendBufferSize: 1000,
         reuseAddress: true,
         socketTimeout: 3000,
-  },err => {
+    }, err => {
         if (err) {
             console.log('setExtraOptions fail');
             return;
         }
         console.log('setExtraOptions success');
     });
-}).catch(err => {
-  console.log('connect fail');
 });
 ```
 
-
 ### setExtraOptions
 
 setExtraOptions(options: TCPExtraOptions): Promise\<void\>
 
 设置TCPSocket连接的其他属性，使用Promise方式作为异步方法。
 
->**说明：** 
->bind或connect方法调用成功后，才可调用此方法。
+> **说明：**
+> bind或connect方法调用成功后，才可调用此方法。
 
 **需要权限**：ohos.permission.INTERNET
 
@@ -1351,14 +1309,14 @@ setExtraOptions(options: TCPExtraOptions): Promise\<void\>
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let promise = tcp.connect({ address: {address: '192.168.xx.xxx', port: xxxx, family: 1} , timeout: 6000});
+let promise = tcp.connect({address: {address: '192.168.xx.xxx', port: xxxx, family: 1}, timeout: 6000});
 promise.then(() => {
     console.log('connect success');
     let promise1 = tcp.setExtraOptions({
         keepAlive: true,
         OOBInline: true,
         TCPNoDelay: true,
-	socketLinger: { on:true, linger:10 },
+        socketLinger: {on: true, linger: 10},
         receiveBufferSize: 1000,
         sendBufferSize: 1000,
         reuseAddress: true,
@@ -1374,7 +1332,6 @@ promise.then(() => {
 });
 ```
 
-
 ### on('message')
 
 on(type: 'message', callback: Callback<{message: ArrayBuffer, remoteInfo: SocketRemoteInfo}\>): void
@@ -1399,15 +1356,14 @@ tcp.on('message', value => {
 });
 ```
 
-
 ### off('message')
 
 off(type: 'message', callback?: Callback<{message: ArrayBuffer, remoteInfo: SocketRemoteInfo}\>): void
 
 取消订阅TCPSocket连接的接收消息事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -1422,7 +1378,7 @@ off(type: 'message', callback?: Callback<{message: ArrayBuffer, remoteInfo: Sock
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let callback = value =>{
+let callback = value => {
     console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
 }
 tcp.on('message', callback);
@@ -1431,7 +1387,6 @@ tcp.off('message', callback);
 tcp.off('message');
 ```
 
-
 ### on('connect' | 'close')
 
 on(type: 'connect' | 'close', callback: Callback\<void\>): void
@@ -1459,15 +1414,14 @@ tcp.on('close', data => {
 });
 ```
 
-
 ### off('connect' | 'close')
 
 off(type: 'connect' | 'close', callback?: Callback\<void\>): void
 
 取消订阅TCPSocket的连接事件或关闭事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -1482,14 +1436,14 @@ off(type: 'connect' | 'close', callback?: Callback\<void\>): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let callback1 = () =>{
+let callback1 = () => {
     console.log("on connect success");
 }
 tcp.on('connect', callback1);
 // 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 tcp.off('connect', callback1);
 tcp.off('connect');
-let callback2 = () =>{
+let callback2 = () => {
     console.log("on close success");
 }
 tcp.on('close', callback2);
@@ -1498,7 +1452,6 @@ tcp.off('close', callback2);
 tcp.off('close');
 ```
 
-
 ### on('error')
 
 on(type: 'error', callback: ErrorCallback): void
@@ -1523,15 +1476,14 @@ tcp.on('error', err => {
 });
 ```
 
-
 ### off('error')
 
 off(type: 'error', callback?: ErrorCallback): void
 
 取消订阅TCPSocket连接的error事件。使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -1546,7 +1498,7 @@ off(type: 'error', callback?: ErrorCallback): void
 
 ```js
 let tcp = socket.constructTCPSocketInstance();
-let callback = err =>{
+let callback = err => {
     console.log("on error, err:" + JSON.stringify(err));
 }
 tcp.on('error', callback);
@@ -1555,7 +1507,6 @@ tcp.off('error', callback);
 tcp.off('error');
 ```
 
-
 ## TCPConnectOptions
 
 TCPSocket连接的参数。
@@ -1769,12 +1720,11 @@ getState(): Promise\<SocketStateBase\>
 **示例：**
 
 ```js
-tls.bind({address: '192.168.xx.xxx', port: xxxx, family: 1}, err => {
-  if (err) {
-    console.log('bind fail');
-    return;
-  }
+let promiseBind = tls.bind({address: '192.168.xx.xxx', port: xxxx, family: 1});
+promiseBind.then(() => {
     console.log('bind success');
+}).catch((err) => {
+    console.log('bind fail');
 });
 let promise = tls.getState();
 promise.then(() => {
@@ -1822,18 +1772,19 @@ tls.setExtraOptions({
     keepAlive: true,
     OOBInline: true,
     TCPNoDelay: true,
-  socketLinger: { on:true, linger:10 },
+    socketLinger: {on: true, linger: 10},
     receiveBufferSize: 1000,
     sendBufferSize: 1000,
     reuseAddress: true,
     socketTimeout: 3000,
-},err => {
+}, err => {
     if (err) {
         console.log('setExtraOptions fail');
         return;
     }
     console.log('setExtraOptions success');
 });
+
 ```
 
 ### setExtraOptions<sup>9+</sup>
@@ -1878,7 +1829,7 @@ let promise = tls.setExtraOptions({
     keepAlive: true,
     OOBInline: true,
     TCPNoDelay: true,
-  socketLinger: { on:true, linger:10 },
+    socketLinger: {on: true, linger: 10},
     receiveBufferSize: 1000,
     sendBufferSize: 1000,
     reuseAddress: true,
@@ -1956,12 +1907,12 @@ let options = {
     },
 };
 tlsTwoWay.connect(options, (err, data) => {
-  console.error("connect callback error"+err);
+    console.error("connect callback error" + err);
     console.log(JSON.stringify(data));
 });
 
 let tlsOneWay = socket.constructTLSSocketInstance(); // One way authentication
-  tlsOneWay.bind({address: '192.168.xxx.xxx', port: 8080, family: 1}, err => {
+tlsOneWay.bind({address: '192.168.xxx.xxx', port: 8080, family: 1}, err => {
     if (err) {
         console.log('bind fail');
         return;
@@ -1975,12 +1926,12 @@ let oneWayOptions = {
         family: 1,
     },
     secureOptions: {
-    ca: ["xxxx","xxxx"],
+        ca: ["xxxx", "xxxx"],
         cipherSuite: "AES256-SHA256",
     },
 };
 tlsOneWay.connect(oneWayOptions, (err, data) => {
-  console.error("connect callback error"+err);
+    console.error("connect callback error" + err);
     console.log(JSON.stringify(data));
 });
 ```
@@ -2075,7 +2026,7 @@ let oneWayOptions = {
         family: 1,
     },
     secureOptions: {
-    ca: ["xxxx","xxxx"],
+        ca: ["xxxx", "xxxx"],
         cipherSuite: "AES256-SHA256",
     },
 };
@@ -2551,7 +2502,7 @@ send(data: string): Promise\<void\>
 **示例：**
 
 ```js
-tls.send("xxxx").then(() =>{
+tls.send("xxxx").then(() => {
     console.log("send success");
 }).catch(err => {
     console.error(err);
@@ -2619,7 +2570,7 @@ close(): Promise\<void\>
 **示例：**
 
 ```js
-tls.close().then(() =>{
+tls.close().then(() => {
     console.log("close success");
 }).catch(err => {
     console.error(err);

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

@@ -5,11 +5,13 @@
 > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
 
 
-使用WebSocket建立服务器与客户端的双向连接，需要先通过[createWebSocket](#websocketcreatewebsocket)方法创建[WebSocket](#websocket)对象，然后通过[connect](#connect)方法连接到服务器。当连接成功后，客户端会收到[open](#onopen)事件的回调，之后客户端就可以通过[send](#send)方法与服务器进行通信。当服务器发信息给客户端时，客户端会收到[message](#onmessage)事件的回调。当客户端不要此连接时，可以通过调用[close](#close)方法主动断开连接，之后客户端会收到[close](#onclose)事件的回调。
+使用WebSocket建立服务器与客户端的双向连接，需要先通过[createWebSocket](#websocketcreatewebsocket)方法创建[WebSocket](#websocket)
+对象，然后通过[connect](#connect)方法连接到服务器。当连接成功后，客户端会收到[open](#onopen)事件的回调，之后客户端就可以通过[send](#send)
+方法与服务器进行通信。当服务器发信息给客户端时，客户端会收到[message](#onmessage)事件的回调。当客户端不要此连接时，可以通过调用[close](#close)
+方法主动断开连接，之后客户端会收到[close](#onclose)事件的回调。
 
 若在上述任一过程中发生错误，客户端会收到[error](#onerror)事件的回调。
 
-
 ## 导入模块
 
 ```js
@@ -21,9 +23,13 @@ import webSocket from '@ohos.net.webSocket';
 ```js
 import webSocket from '@ohos.net.webSocket';
 
-var defaultIpAddress = "ws://";
+let defaultIpAddress = "ws://";
 let ws = webSocket.createWebSocket();
 ws.on('open', (err, value) => {
+    if (err != undefined) {
+        console.log(JSON.stringify(err))
+        return
+    }
     console.log("on open, status:" + value['status'] + ", message:" + value['message']);
     // 当收到on('open')事件时，可以通过send()方法与服务器进行通信
     ws.send("Hello, server!", (err, value) => {
@@ -82,7 +88,6 @@ createWebSocket(): WebSocket
 let ws = webSocket.createWebSocket();
 ```
 
-
 ## WebSocket
 
 在调用WebSocket的方法前，需要先通过[webSocket.createWebSocket](#websocketcreatewebsocket)创建一个WebSocket。
@@ -125,7 +130,6 @@ ws.connect(url, (err, value) => {
 });
 ```
 
-
 ### connect
 
 connect(url: string, options: WebSocketRequestOptions, callback: AsyncCallback\<boolean\>): void
@@ -170,7 +174,6 @@ ws.connect(url, {
 });
 ```
 
-
 ### connect
 
 connect(url: string, options?: WebSocketRequestOptions): Promise\<boolean\>
@@ -214,7 +217,6 @@ promise.then((value) => {
 });
 ```
 
-
 ### send
 
 send(data: string | ArrayBuffer, callback: AsyncCallback\<boolean\>): void
@@ -255,7 +257,6 @@ ws.connect(url, (err, value) => {
 });
 ```
 
-
 ### send
 
 send(data: string | ArrayBuffer): Promise\<boolean\>
@@ -300,7 +301,6 @@ ws.connect(url, (err, value) => {
 });
 ```
 
-
 ### close
 
 close(callback: AsyncCallback\<boolean\>): void
@@ -328,7 +328,6 @@ close(callback: AsyncCallback\<boolean\>): void
 
 ```js
 let ws = webSocket.createWebSocket();
-let url = "ws://"
 ws.close((err, value) => {
     if (!err) {
         console.log("close success")
@@ -338,7 +337,6 @@ ws.close((err, value) => {
 });
 ```
 
-
 ### close
 
 close(options: WebSocketCloseOptions, callback: AsyncCallback\<boolean\>): void
@@ -367,7 +365,6 @@ close(options: WebSocketCloseOptions, callback: AsyncCallback\<boolean\>): void
 
 ```js
 let ws = webSocket.createWebSocket();
-let url = "ws://"
 ws.close({
     code: 1000,
     reason: "your reason"
@@ -380,7 +377,6 @@ ws.close({
 });
 ```
 
-
 ### close
 
 close(options?: WebSocketCloseOptions): Promise\<boolean\>
@@ -414,7 +410,6 @@ close(options?: WebSocketCloseOptions): Promise\<boolean\>
 
 ```js
 let ws = webSocket.createWebSocket();
-let url = "ws://"
 let promise = ws.close({
     code: 1000,
     reason: "your reason"
@@ -426,7 +421,6 @@ promise.then((value) => {
 });
 ```
 
-
 ### on('open')
 
 on(type: 'open', callback: AsyncCallback\<Object\>): void
@@ -442,7 +436,6 @@ on(type: 'open', callback: AsyncCallback\<Object\>): void
 | type     | string                  | 是   | 'open'：WebSocket的打开事件。 |
 | callback | AsyncCallback\<Object\> | 是   | 回调函数。                    |
 
-
 **示例：**
 
 ```js
@@ -452,15 +445,14 @@ ws.on('open', (err, value) => {
 });
 ```
 
-
 ### off('open')
 
 off(type: 'open', callback?: AsyncCallback\<Object\>): void
 
 取消订阅WebSocket的打开事件，使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -483,15 +475,14 @@ ws.on('open', callback1);
 ws.off('open', callback1);
 ```
 
-
 ### on('message')
 
 on(type: 'message', callback: AsyncCallback\<string | ArrayBuffer\>): void
 
 订阅WebSocket的接收到服务器消息事件，使用callback方式作为异步方法。每个消息最大长度为4K，超过4K自动分片。
 
->**说明：** 
->AsyncCallback中的数据可以是字符串(API 6)或ArrayBuffer(API 8)。
+> **说明：**
+> AsyncCallback中的数据可以是字符串(API 6)或ArrayBuffer(API 8)。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -511,16 +502,15 @@ ws.on('message', (err, value) => {
 });
 ```
 
-
 ### off('message')
 
 off(type: 'message', callback?: AsyncCallback\<string | ArrayBuffer\>): void
 
 取消订阅WebSocket的接收到服务器消息事件，使用callback方式作为异步方法。每个消息最大长度为4K，超过4K自动分片。
 
->**说明：** 
->AsyncCallback中的数据可以是字符串(API 6)或ArrayBuffer(API 8)。
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> AsyncCallback中的数据可以是字符串(API 6)或ArrayBuffer(API 8)。
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -538,7 +528,6 @@ let ws = webSocket.createWebSocket();
 ws.off('message');
 ```
 
-
 ### on('close')
 
 on(type: 'close', callback: AsyncCallback\<{ code: number, reason: string }\>): void
@@ -563,15 +552,14 @@ ws.on('close', (err, value) => {
 });
 ```
 
-
 ### off('close')
 
 off(type: 'close', callback?: AsyncCallback\<{ code: number, reason: string }\>): void
 
 取消订阅WebSocket的关闭事件，使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -589,7 +577,6 @@ let ws = webSocket.createWebSocket();
 ws.off('close');
 ```
 
-
 ### on('error')
 
 on(type: 'error', callback: ErrorCallback): void
@@ -614,15 +601,14 @@ ws.on('error', (err) => {
 });
 ```
 
-
 ### off('error')
 
 off(type: 'error', callback?: ErrorCallback): void
 
 取消订阅WebSocket的Error事件，使用callback方式作为异步方法。
 
->**说明：** 
->可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
+> **说明：**
+> 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
 
 **系统能力**：SystemCapability.Communication.NetStack
 
@@ -640,7 +626,6 @@ let ws = webSocket.createWebSocket();
 ws.off('error');
 ```
 
-
 ## WebSocketRequestOptions
 
 建立WebSocket连接时，可选参数的类型和说明。
@@ -651,7 +636,6 @@ ws.off('error');
 | ------ | ------ | ---- | ------------------------------------------------------------ |
 | header | Object | 否   | 建立WebSocket连接可选参数，代表建立连接时携带的HTTP头信息。参数内容自定义，也可以不指定。 |
 
-
 ## WebSocketCloseOptions
 
 关闭WebSocket连接时，可选参数的类型和说明。