Description: fix comments

Signed-off-by: N zhanghaifeng <zhanghaifeng11@huawei.com>

Description: fix comments
Signed-off-by: N zhanghaifeng <zhanghaifeng11@huawei.com>
410df270 · zhanghaifeng · 9d4394f1 · 410df270 · 410df270 · 410df270
8 changed file
--- a/zh-cn/application-dev/connectivity/net-connection-manager.md
+++ b/zh-cn/application-dev/connectivity/net-connection-manager.md
@@ -4,7 +4,7 @@
 网络连接管理提供管理网络一些基础能力，包括WiFi/蜂窝/Ethernet等多网络连接优先级管理、网络质量评估、订阅默认/指定网络连接状态变化、查询网络连接信息、DNS解析等功能。

 > **说明：**
-> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-connection.md)。

 ## 基本概念
 -  网络生产者：数据网络的提供方，比如WiFi、蜂窝、Ethernet等。
@@ -15,6 +15,7 @@
 ## 约束
 -   开发语言：C++ JS
 -   系统：linux内核
+-   本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 场景介绍
 网络连接管理的典型场景有：
@@ -25,48 +26,30 @@

 以下分别介绍具体开发方式。
 ## 接口说明
-完整的JS API说明以及实例代码请参考：[网络连接管理](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-net-connection.md)。
+完整的JS API说明以及实例代码请参考：[网络连接管理](../reference/apis/js-apis-net-connection.md)。

 | 类型 | 接口 | 功能说明 |
 | ---- | ---- | ---- |
 | ohos.net.connection | function getDefaultNet(callback: AsyncCallback\<NetHandle>): void; |获取一个含有默认网络的netId的NetHandle对象，使用callback回调 |
-| ohos.net.connection | function getDefaultNet(): Promise\<NetHandle>; |获取一个含有默认网络的netId的NetHandle对象，使用Promise回调 |
 | ohos.net.connection | function getGlobalHttpProxy<sup>10+</sup>(callback: AsyncCallback\<HttpProxy>): void;| 获取网络的全局代理设置，使用callback回调 |
-| ohos.net.connection | function getGlobalHttpProxy<sup>10+</sup>(): Promise\<HttpProxy>;| 获取网络的全局代理设置，使用Promise回调 |
 | ohos.net.connection | function setGlobalHttpProxy<sup>10+</sup>(httpProxy: HttpProxy, callback: AsyncCallback<void>): void;| 设置网络全局Http代理配置信息，使用callback回调 |
-| ohos.net.connection | function setGlobalHttpProxy<sup>10+</sup>(httpProxy: HttpProxy): Promise<void>;| 设置网络全局Http代理配置信息，使用Promise回调 |
 | ohos.net.connection | function getAppNet<sup>9+</sup>(callback: AsyncCallback\<NetHandle>): void;| 获取一个App绑定的包含了网络netId的NetHandle对象，使用callback回调 |
-| ohos.net.connection | function getAppNet<sup>9+</sup>(): Promise\<NetHandle>;| 获取一个App绑定的包含了网络netId的NetHandle对象，使用Promise回调 |
 | ohos.net.connection | function setAppNet<sup>9+</sup>(netHandle: NetHandle, callback: AsyncCallback\<void>): void;| 绑定App到指定网络，绑定后的App只能通过指定网络访问外网。使用callback回调 |
-| ohos.net.connection | function setAppNet<sup>9+</sup>(netHandle: NetHandle): Promise\<void>;| 绑定App到指定网络，绑定后的App只能通过指定网络访问外网。使用Promise回调 |
 | ohos.net.connection | function getDefaultNetSync<sup>9+</sup>(): NetHandle; |使用同步方法获取默认激活的数据网络。可以使用getNetCapabilities去获取网络的类型、拥有的能力等信息。|
 | ohos.net.connection | function hasDefaultNet(callback: AsyncCallback\<boolean>): void; |查询是否有默认网络，使用callback回调 |
-| ohos.net.connection | function hasDefaultNet(): Promise\<boolean>; |查询是否有默认网络，使用Promise回调 |
 | ohos.net.connection | function getAllNets(callback: AsyncCallback\<Array\<NetHandle>>): void;| 获取所处于连接状态的网络的MetHandle对象列表，使用callback回调 |
-| ohos.net.connection | function getAllNets(): Promise\<Array\<NetHandle>>;| 获取所有处于连接状态的网络的NetHandle对象列表，使用Promise回调 |
 | ohos.net.connection | function getConnectionProperties(netHandle: NetHandle, callback: AsyncCallback\<ConnectionProperties>): void; |查询默认网络的链路信息，使用callback回调 |
-| ohos.net.connection | function getConnectionProperties(netHandle: NetHandle): Promise\<ConnectionProperties>; |查询默认网络的链路信息，使用Promise回调 |
 | ohos.net.connection | function getNetCapabilities(netHandle: NetHandle, callback: AsyncCallback\<NetCapabilities>): void; |查询默认网络的能力集信息，使用callback回调 |
-| ohos.net.connection | function getNetCapabilities(netHandle: NetHandle): Promise\<NetCapabilities>; |查询默认网络的能力集信息，使用Promise回调 |
 | ohos.net.connection | function isDefaultNetMetered<sup>9+</sup>(callback: AsyncCallback<boolean>): void; |检查当前网络上的数据流量使用是否被计量，使用callback方式作为异步方法 |
-| ohos.net.connection | function isDefaultNetMetered<sup>9+</sup>(): Promise<boolean>; |检查当前网络上的数据流量使用是否被计量，使用Promise方式作为异步方法 |
 | ohos.net.connection | function reportNetConnected(netHandle: NetHandle, callback: AsyncCallback\<void>): void;| 向网络管理报告网络处于可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。使用callback回调 |
-| ohos.net.connection | function reportNetConnected(netHandle: NetHandle): Promise\<void>;| 向网络管理报告网络处于可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。使用Promise回调 |
 | ohos.net.connection | function reportNetDisconnected(netHandle: NetHandle, callback: AsyncCallback\<void>): void;| 向网络管理报告网络处于不可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。使用callback回调 |
-| ohos.net.connection | function reportNetDisconnected(netHandle: NetHandle): Promise\<void>;| 向网络管理报告网络处于不可用状态，调用此接口说明应用程序认为网络的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）与网络管理不一致。使用Promise回调 |
 | ohos.net.connection | function getAddressesByName(host: string, callback: AsyncCallback\<Array\<NetAddress>>): void; |使用对应网络解析域名，获取所有IP，使用callback回调 |
-| ohos.net.connection | function getAddressesByName(host: string): Promise\<Array\<NetAddress>>; |使用默认网络解析域名，获取所有IP，使用Promise回调 |
 | ohos.net.connection | function enableAirplaneMode(callback: AsyncCallback\<void>): void; | 设置网络为飞行模式，使用callback回调 |
-| ohos.net.connection | function enableAirplaneMode(): Promise\<void>;|设置网络为飞行模式，使用Promise回调 |
 | ohos.net.connection | function disableAirplaneMode(callback: AsyncCallback\<void>): void;| 关闭网络飞行模式，使用callback回调 |
-| ohos.net.connection | function disableAirplaneMode(): Promise\<void>;| 关闭网络飞行模式，使用Promise回调 |
 | ohos.net.connection | function createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection; | 返回一个NetConnection对象，netSpecifier指定关注的网络的各项特征，timeout是超时时间(单位是毫秒)，netSpecifier是timeout的必要条件，两者都没有则表示关注默认网络 |
 | ohos.net.connection.NetHandle | bindSocket(socketParam: TCPSocket \| UDPSocket, callback: AsyncCallback\<void>): void; | 将TCPSocket或UDPSockett绑定到当前网络，使用callback回调 |
-| ohos.net.connection.NetHandle | bindSocket(socketParam: TCPSocket \| UDPSocket): Promise\<void>;| 将TCPSocket或UDPSockett绑定到当前网络，使用Promise回调 |
 | ohos.net.connection.NetHandle | getAddressesByName(host: string, callback: AsyncCallback\<Array\<NetAddress>>): void; |使用默认网络解析域名，获取所有IP，使用callback回调 |
-| ohos.net.connection.NetHandle | getAddressesByName(host: string): Promise\<Array\<NetAddress>>; |使用对应网络解析域名，获取所有IP，使用Promise回调 |
 | ohos.net.connection.NetHandle | getAddressByName(host: string, callback: AsyncCallback\<NetAddress>): void; |使用对应网络解析域名，获取一个IP，调用callbac |
-| ohos.net.connection.NetHandle | getAddressByName(host: string): Promise\<NetAddress>; |使用对应网络解析域名，获取一个IP，使用Promise回调 |
 | ohos.net.connection.NetConnection | on(type: 'netAvailable', callback: Callback\<NetHandle>): void; |监听收到网络可用的事件 |
 | ohos.net.connection.NetConnection | on(type: 'netCapabilitiesChange', callback: Callback\<{ netHandle: NetHandle, netCap: NetCapabilities }>): void; |监听网络能力变化的事件 |
 | ohos.net.connection.NetConnection | on(type: 'netConnectionPropertiesChange', callback: Callback\<{ netHandle: NetHandle, connectionProperties: ConnectionProperties }>): void; |监听网络连接信息变化的事件 |
@@ -78,8 +61,6 @@

 ## 接收指定网络的状态变化通知

-### 开发步骤
-
 1. 从@ohos.net.connection.d.ts中导入connection命名空间。

 2. 调用createNetConnection方法，指定网络能力、网络类型和超时时间（可选，如不传入代表默认网络；创建不同于默认网络时可通过指定这些参数完成），创建一个NetConnection对象。

--- a/zh-cn/application-dev/connectivity/net-ethernet.md
+++ b/zh-cn/application-dev/connectivity/net-ethernet.md
@@ -2,14 +2,15 @@

 ## 简介
 以太网连接的功能是提供支持设备通过硬件接口，以插入网线的形式访问互联网的能力。
-设备接入网线后，可以获取动态分配的IP地址，xxx等一系列网络属性；也可以通过静态模式，手动配置与获取设备的网络属性。
+设备接入网线后，可以获取动态分配的IP地址，子网掩码，Gateway，DNS等一系列网络属性；通过静态模式，手动配置与获取设备的网络属性。

 > **说明：**
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-ethernet.md)。

 ## 约束
 -   开发语言：C++ JS
 -   系统：linux内核
+-   本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 场景介绍
 以太网连接的典型场景有：
@@ -19,23 +20,17 @@
 以下分别介绍具体开发方式。

 ## 接口说明
-完整的JS API说明以及实例代码请参考：[以太网连接](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md)。
+完整的JS API说明以及实例代码请参考：[以太网连接](../reference/apis/js-apis-net-ethernet.md)。

 | 类型 | 接口 | 功能说明 |
 | ---- | ---- | ---- |
 | ohos.net.ethernet | function setIfaceConfig(iface: string, ic: InterfaceConfiguration, callback: AsyncCallback\<void>): void | 配置指定以太网的网络属性，iface为网口名称，ic为配置信息，调用callback |
-| ohos.net.ethernet | function setIfaceConfig(iface: string, ic: InterfaceConfiguration): Promise\<boolean>; | 配置指定以太网的网络属性，iface为网口名称，ic为配置信息，返回promise |
 | ohos.net.ethernet | function getIfaceConfig(iface: string, callback: AsyncCallback\<InterfaceConfiguration>): void | 获取指定以太网的网络属性，iface为网口名称，调用callback |
-| ohos.net.ethernet | function getIfaceConfig(iface: string): Promise\<InterfaceConfiguration>; | 获取指定以太网的网络属性，iface为网口名称，返回promise |
 | ohos.net.ethernet | function isIfaceActive(iface: string, callback: AsyncCallback\<number>): void | 判断指定网口是否已激活，iface为网卡名称（无参为是否有激活网口），调用callback |
-| ohos.net.ethernet | function isIfaceActive(iface: string): Promise\<number>; | 判断指定网口是否已激活，iface为网卡名称（无参为是否有激活网口），返回promise |
 | ohos.net.ethernet | function getAllActiveIfaces(callback: AsyncCallback\<Array\<string>>): void; | 获取所有活动的网络接口，调用callback |
-| ohos.net.ethernet | function getAllActiveIfaces(): Promise\<Array\<string>>; | 获取所有活动的网络接口，返回promise |

 ## 以太网连接-DHCP模式

-### 开发步骤
-
 1. 设备通过硬件接口，插入网线。
 2. 从@ohos.net.ethernet中导入ethernet命名空间。
 3. 调用getAllActiveIfaces方法，获取所有激活的有线网卡名称，如：“eth0”，“eth1”。

--- a/zh-cn/application-dev/connectivity/net-policy-management.md
+++ b/zh-cn/application-dev/connectivity/net-policy-management.md
@@ -5,7 +5,7 @@
 网络策略管理提供一些限制网络的基础能力，包括蜂窝网络策略、休眠/省电模式策略、后台网络策略、重置网络策略等功能。

 > **说明：**
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-policy.md)。

 ## 基本概念

@@ -19,6 +19,7 @@

 - 开发语言：C++ JS
 - 系统：linux内核
+- 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 场景介绍

@@ -42,39 +43,22 @@
 | 类型 | 接口 | 功能说明 |
 | ---- | ---- | ---- |
 | ohos.net.policy | function setBackgroundPolicy(isAllowed: boolean, callback: AsyncCallback\<void>): void |设置后台网络策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function setBackgroundPolicy(isAllowed: boolean): Promise\<void> |设置后台网络策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function isBackgroundAllowed(callback: AsyncCallback\<boolean>): void; |获取后台网络策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function isBackgroundAllowed(): Promise\<boolean>; |获取后台网络策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback\<void>): void; |设置对应uid应用的访问计量网络的策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function setPolicyByUid(uid: number, policy: NetUidPolicy): Promise\<void>;| 设置对应uid应用的访问计量网络的策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getPolicyByUid(uid: number, callback: AsyncCallback\<NetUidPolicy>): void;| 通过应用uid获取策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function getPolicyByUid(uid: number): Promise\<NetUidPolicy>; | 通过应用uid获取策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback\<Array\<number>>): void; | 通过策略获取设置这一策略的应用uid数组，使用callback方式作为异步方法 |
-| ohos.net.policy | function getUidsByPolicy(policy: NetUidPolicy): Promise\<Array\<number>>; | 通过策略获取设置这一策略的应用uid数组，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getNetQuotaPolicies(callback: AsyncCallback\<Array\<NetQuotaPolicy>>): void; |获取计量网络策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function getNetQuotaPolicies(): Promise\<Array\<NetQuotaPolicy>>; |获取计量网络策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function setNetQuotaPolicies(quotaPolicies: Array\<NetQuotaPolicy>, callback: AsyncCallback\<void>): void; |设置计量网络策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function setNetQuotaPolicies(quotaPolicies: Array\<NetQuotaPolicy>): Promise\<void>; | 设置计量网络策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function restoreAllPolicies(iccid: string, callback: AsyncCallback\<void>): void; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function restoreAllPolicies(iccid: string): Promise\<void>; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback\<boolean>): void; | 获取对应uid能否访问计量或非计量网络，使用callback方式作为异步方法 |
-| ohos.net.policy | function isUidNetAllowed(uid: number, isMetered: boolean): Promise\<boolean>; | 获取对应uid能否访问计量或非计量网络，使用Promise方式作为异步方法 |
 | ohos.net.policy | function isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback\<boolean>): void; | 获取对应uid能否访问指定的iface的网络，使用callback方式作为异步方法 |
-| ohos.net.policy | function isUidNetAllowed(uid: number, iface: string): Promise\<boolean>; | 获取对应uid能否访问指定的iface的网络，使用Promise方式作为异步方法 |
 | ohos.net.policy | function setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void; | 设置指定uid应用是否在休眠防火墙的白名单，使用callback方式作为异步方法 |
-| ohos.net.policy | function setDeviceIdleAllowList(uid: number, isAllowed: boolean): Promise\<void>; | 设置指定uid应用是否在休眠防火墙的白名单，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getDeviceIdleAllowList(callback: AsyncCallback\<Array\<number>>): void; | 获取休眠模式白名单所包含的uid数组，使用callback方式作为异步方法 |
-| ohos.net.policy | function getDeviceIdleAllowList(): Promise\<Array\<number>>; | 获取休眠模式白名单所包含的uid数组，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getBackgroundPolicyByUid(uid: number, callback: AsyncCallback\<NetBackgroundPolicy>): void; | 获取指定uid能否访问后台网络，使用callback方式作为异步方法 |
-| ohos.net.policy | function getBackgroundPolicyByUid(uid: number): Promise\<NetBackgroundPolicy>; | 获取指定uid能否访问后台网络，使用Promise方式作为异步方法 |
 | ohos.net.policy | function resetPolicies(iccid: string, callback: AsyncCallback\<void>): void; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function resetPolicies(iccid: string): Promise\<void>; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用Promise方式作为异步方法 |
 | ohos.net.policy | function updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback\<void>): void; | 更新提醒策略，使用callback方式作为异步方法 |
-| ohos.net.policy | function updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType): Promise\<void>; | 更新提醒策略，使用Promise方式作为异步方法。 |
 | ohos.net.policy | function setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void; | 设置指定uid应用是否在省电防火墙的白名单，使用callback方式作为异步方法 |
-| ohos.net.policy | function setPowerSaveAllowList(uid: number, isAllowed: boolean): Promise\<void>; | 设置指定uid应用是否在省电防火墙的白名单，使用Promise方式作为异步方法 |
 | ohos.net.policy | function getPowerSaveAllowList(callback: AsyncCallback\<Array\<number>>): void; | 获取省电模式白名单所包含的uid数组，使用callback方式作为异步方法 |
-| ohos.net.policy | function getPowerSaveAllowList(): Promise\<Array\<number>>; | 获取休眠模式白名单所包含的uid数组，使用Promise方式作为异步方法 |
 | ohos.net.policy | function on(type: "netUidPolicyChange", callback: Callback\<{ uid: number, policy: NetUidPolicy }>): void; | 订阅policy发生改变时的回调，使用callback方式作为异步方法 |
 | ohos.net.policy | function off(type: "netUidPolicyChange", callback: Callback\<{ uid: number, policy: NetUidPolicy }>): void; | 取消订阅policy发生改变时的回调，使用callback方式作为异步方法 |
 | ohos.net.policy | function on(type: "netUidRuleChange", callback: Callback\<{ uid: number, rule: NetUidRule }>): void; | 订阅rule发生改变时的回调，使用callback方式作为异步方法 |
@@ -88,8 +72,6 @@

 ## 设置计量网络配额/获取已经设置的计量网络策略

-### 开发步骤
-
 1. 从@ohos.net.policy.d.ts中导入policy命名空间。

 2. 调用setNetQuotaPolicies方法，设置计量网络策略。
@@ -121,8 +103,7 @@
           limitBytes:Number.parseInt(this.limitBytes),

           // 是否为计量网络 true为计量网络 false为非计量网络
-           metered:Boolean(Number.parseInt(this.metered)),
-
+           metered:Boolean(Number.parseInt(this.metered)),https://gitee.com/openharmony/docs/pulls/14404
           // 到达流量限制后的动作 详见[LimitAction](../reference/apis/js-apis-net-policy.md#limitaction)
           limitAction:Number.parseInt(this.limitAction)
       };

--- a/zh-cn/application-dev/connectivity/net-sharing.md
+++ b/zh-cn/application-dev/connectivity/net-sharing.md
@@ -4,7 +4,7 @@
 网络共享管理分享设备已有网络给其他连接设备，支持Wi-Fi热点共享、蓝牙共享和USB共享，同时提供网络共享状态、共享流量查询功能。

 > **说明：**
-> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
+> 为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用callback函数，更多方式可以查阅[API参考](../reference/apis/js-apis-net-sharing.md)。

 ## 基本概念
 -   WIFI共享：通过WIFI热点共享网络。
@@ -14,6 +14,7 @@
 ## 约束
 -   开发语言：C++ JS
 -   系统：linux内核
+-   本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 场景介绍
 网络共享的典型场景有：
@@ -23,30 +24,20 @@

 以下分别介绍具体开发方式。
 ## 接口说明
-完整的JS API说明以及实例代码请参考：[网络共享](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-net-sharing.md)。
+完整的JS API说明以及实例代码请参考：[网络共享](../reference/apis/js-apis-net-sharing.md)。

 | 类型 | 接口 | 功能说明 |
 | ---- | ---- | ---- |
 | ohos.net.sharing | function isSharingSupported(callback: AsyncCallback\<boolean>): void; | 获取当前系统是否支持网络共享，使用callback方式作为异步方法 |
-| ohos.net.sharing | function isSharingSupported(): Promise\<boolean>; | 获取当前系统是否支持网络共享，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function isSharing(callback: AsyncCallback\<boolean>): void; | 获取当前共享状态，使用callback方式作为异步方法 |
-| ohos.net.sharing | function isSharing(): Promise\<boolean>; | 获取当前共享状态，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function startSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void; | 开启共享，type为共享类型，目前支持Wifi热点、蓝牙、USB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function startSharing(type: SharingIfaceType): Promise\<void>; | 开启共享，type为共享类型，目前支持Wifi热点、蓝牙、USB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function stopSharing(type: SharingIfaceType, callback: AsyncCallback\<void>): void; | 停止指定类型共享，type为共享类型，包括Wifi热点、蓝牙、USB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function stopSharing(type: SharingIfaceType): Promise\<void>; | 停止指定类型共享，type为共享类型，包括Wifi热点、蓝牙、USB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getStatsRxBytes(callback: AsyncCallback\<number>): void; | 获取共享接收数据量，单位KB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getStatsRxBytes(): Promise\<number>; | 获取共享接收数据量，单位KB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getStatsTxBytes(callback: AsyncCallback\<number>): void; | 获取共享发送数据量，单位KB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getStatsTxBytes(): Promise\<number>; | 获取共享发送数据量，单位KB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getStatsTotalBytes(callback: AsyncCallback\<number>): void; | 获取共享总数据流量，单位KB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getStatsTotalBytes(): Promise\<number>; | 获取共享总数据流量，单位KB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getSharingIfaces(state: SharingIfaceState, callback: AsyncCallback\<Array\<string>>): void; | 获取指定状态的网卡名称，state为状态，包括正在共享、可共享、共享错误，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getSharingIfaces(state: SharingIfaceState): Promise\<Array\<string>>; | 获取指定状态的网卡名称，state为状态，包括正在共享、可共享、共享错误，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getSharingState(type: SharingIfaceType, callback: AsyncCallback\<SharingIfaceState>): void; | 获取指定类型共享状态，type为类型，目前支持Wifi热点、蓝牙、USB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getSharingState(type: SharingIfaceType): Promise\<SharingIfaceState>; | 获取指定类型共享状态，type为类型，目前支持Wifi热点、蓝牙、USB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function getSharableRegexes(type: SharingIfaceType, callback: AsyncCallback\<Array\<string>>): void; | 获取与指定类型匹配的网卡正则表达式列表，type为类型，目前支持Wifi热点、蓝牙、USB，使用callback方式作为异步方法 |
-| ohos.net.sharing | function getSharableRegexes(type: SharingIfaceType): Promise\<Array\<string>>; | 获取与指定类型匹配的网卡正则表达式列表，type为类型，目前支持Wifi热点、蓝牙、USB，使用Promise方式作为异步方法 |
 | ohos.net.sharing | function on(type: 'sharingStateChange', callback: Callback\<boolean>): void; | 注册共享状态改变监听，返回网络共享的状态。 |
 | ohos.net.sharing | function off(type: 'sharingStateChange', callback?: Callback\<boolean>): void; | 注销共享状态改变监听，返回网络共享的状态。 |
 | ohos.net.sharing | unction on(type: 'interfaceSharingStateChange', callback: Callback\<{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void; | 注册指定网卡共享状态改变监听 |
@@ -56,8 +47,6 @@

 ## 开启网络共享

-### 开发步骤
-
 1. 从@ohos.net.sharing中导入sharing命名空间。
 2. 注册监听共享状态的改变。
 3. 调用startSharing方法，来开启指定类型共享。

--- a/zh-cn/application-dev/connectivity/socket-connection.md
+++ b/zh-cn/application-dev/connectivity/socket-connection.md
@@ -20,7 +20,7 @@ Socket连接主要是通过Socket进行数据传输，支持TCP/UDP/TLS协议。

 ## 接口说明

-完整的JS API说明以及实例代码请参考：[Socket连接](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-socket.md)。
+完整的JS API说明以及实例代码请参考：[Socket连接](../reference/apis/js-apis-socket.md)。

 Socket连接主要由socket模块提供。具体接口说明如下表。

@@ -70,8 +70,6 @@ TLS Socket连接主要由tls_socket模块提供。具体接口说明如下表。

 ## 应用TCP/UDP协议进行通信

-### 开发步骤
-
 UDP与TCP流程大体类似，下面以TCP为例：

 1. import需要的socket模块。

--- a/zh-cn/application-dev/reference/apis/js-apis-net-connection.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-net-connection.md
-# 网络连接管理
+# @ohos.net.connection (网络连接管理)

 网络连接管理提供管理网络一些基础能力，包括获取默认激活的数据网络、获取所有激活数据网络列表、开启关闭飞行模式、获取网络能力信息等功能。

-> ![](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
 > 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 导入模块
@@ -112,7 +112,7 @@ connection.getDefaultNet().then(function (data) {

 ## connection.getGlobalHttpProxy<sup>10+</sup>

-getGlobalHttpProxy(callback: AsyncCallback\<HttpProxy>): void;
+getGlobalHttpProxy(callback: AsyncCallback\<HttpProxy>): void

 获取网络的全局代理配置信息，使用callback方式作为异步方法。

@@ -173,7 +173,7 @@ connection.getGlobalHttpProxy().then((data) => {

 ## connection.setGlobalHttpProxy<sup>10+</sup>

-setGlobalHttpProxy(httpProxy: HttpProxy, callback: AsyncCallback\<void>): void;
+setGlobalHttpProxy(httpProxy: HttpProxy, callback: AsyncCallback\<void>): void

 设置网络全局Http代理配置信息，使用callback方式作为异步方法。

@@ -265,7 +265,7 @@ connection.setGlobalHttpProxy(httpProxy).then((error, data) => {

 ## connection.getAppNet<sup>9+</sup>

-getAppNet(callback: AsyncCallback\<NetHandle>): void;
+getAppNet(callback: AsyncCallback\<NetHandle>): void

 获取App绑定的网络信息，使用callback方式作为异步方法。

@@ -326,7 +326,7 @@ connection.getAppNet().then((data) => {

 ## connection.SetAppNet<sup>9+</sup>

-setAppNet(netHandle: NetHandle, callback: AsyncCallback\<void>): void;
+setAppNet(netHandle: NetHandle, callback: AsyncCallback\<void>): void

 绑定App到指定网络，绑定后的App只能通过指定网络访问外网，使用callback方式作为异步方法。

@@ -1472,7 +1472,7 @@ netCon.unregister(function (error) {

 ### bindSocket<sup>9+</sup>

-bindSocket(socketParam: TCPSocket \| UDPSocket, callback: AsyncCallback\<void>): void;
+bindSocket(socketParam: TCPSocket \| UDPSocket, callback: AsyncCallback\<void>): void

 将TCPSocket或UDPSocket绑定到当前网络，使用callback方式作为异步方法。


--- a/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md
-# 以太网连接
+# @ohos.net.ethernet (以太网连接管理)

 以太网连接管理主要提供有线网络能力，提供设置有线网络的IP地址，子网掩码，网关，DNS等信息

-> ![](public_sys-resources/icon-note.gif) **说明：**
+> **说明：**
 > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

 ## 导入模块

--- a/zh-cn/application-dev/reference/apis/js-apis-net-policy.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-net-policy.md
-# 网络策略管理
+# @ohos.net.policy (网络策略管理)

 网络策略管理通过对用户使用数据流量进行控制管理，采用防火墙技术实现网络策略的管理。

@@ -92,7 +92,7 @@ policy.setBackgroundPolicy(Boolean(Number.parseInt(this.isBoolean))).then((error

 ## policy.isBackgroundAllowed

-isBackgroundAllowed(callback: AsyncCallback\<boolean>): void;
+isBackgroundAllowed(callback: AsyncCallback\<boolean>): void

 获取后台网络策略，使用callback方式作为异步方法。

@@ -138,7 +138,7 @@ isBackgroundAllowed(): Promise\<boolean>;

 | 类型                              | 说明                                  |
 | --------------------------------- | ------------------------------------- |
-| Promise\<boolean> | 以Promise形式返回设定结果。失败返回错误码错误信息。 |
+| Promise\<boolean> | 以Promise形式返回设定结果。 返回true代表后台策略为允许。失败返回错误码错误信息。|

 **错误码：**

@@ -160,7 +160,7 @@ policy.isBackgroundAllowed().then((error, data) {

 ## policy.setPolicyByUid

-setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback\<void>): void;
+setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback\<void>): void

 设置对应uid应用的访问计量网络的策略，使用callback方式作为异步方法。

@@ -245,7 +245,7 @@ policy.setPolicyByUid(Number.parseInt(this.firstParam), Number.parseInt(this.cur

 ## policy.getPolicyByUid

-getPolicyByUid(uid: number, callback: AsyncCallback\<NetUidPolicy>): void;
+getPolicyByUid(uid: number, callback: AsyncCallback\<NetUidPolicy>): void

 通过应用uid获取策略，使用callback方式作为异步方法。

@@ -322,7 +322,7 @@ policy.getPolicyByUid(Number.parseInt(this.firstParam)).then((error, data) {

 ## policy.getUidsByPolicy

-getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback\<Array\<number>>): void;
+getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback\<Array\<number>>): void

 通过策略获取设置这一策略的应用uid数组，使用callback方式作为异步方法。

@@ -399,7 +399,7 @@ policy.getUidsByPolicy(Number.parseInt(this.firstParam)).then((error, data) {

 ## policy.getNetQuotaPolicies

-getNetQuotaPolicies(callback: AsyncCallback\<Array\<NetQuotaPolicy>>): void;
+getNetQuotaPolicies(callback: AsyncCallback\<Array\<NetQuotaPolicy>>): void

 获取计量网络策略，使用callback方式作为异步方法。

@@ -465,7 +465,7 @@ policy.getNetQuotaPolicies().then((error, data) {

 ## policy.setNetQuotaPolicies

-setNetQuotaPolicies(quotaPolicies: Array\<NetQuotaPolicy>, callback: AsyncCallback\<void>): void;
+setNetQuotaPolicies(quotaPolicies: Array\<NetQuotaPolicy>, callback: AsyncCallback\<void>): void

 设置计量网络策略，使用callback方式作为异步方法。

@@ -549,7 +549,7 @@ policy.setNetQuotaPolicies(this.netQuotaPolicyList).then((error, data) {

 ## policy.restoreAllPolicies

-restoreAllPolicies(iccid: string, callback: AsyncCallback\<void>): void;
+restoreAllPolicies(iccid: string, callback: AsyncCallback\<void>): void

 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用callback方式作为异步方法。

@@ -628,7 +628,7 @@ policy.restoreAllPolicies(this.firstParam).then((error, data){

 ## policy.isUidNetAllowed

-isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback\<boolean>): void;
+isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback\<boolean>): void

 获取对应uid能否访问计量或非计量网络，使用callback方式作为异步方法。

@@ -715,7 +715,7 @@ policy.isUidNetAllowed(Number.parseInt(this.firstParam), Boolean(Number.parseInt

 ## policy.isUidNetAllowed

-isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback\<boolean>): void;
+isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback\<boolean>): void

 获取对应uid能否访问指定的iface的网络，使用callback方式作为异步方法。

@@ -801,7 +801,7 @@ policy.isUidNetAllowed(Number.parseInt(this.firstParam), this.secondParam).then(

 ## policy.setDeviceIdleAllowList

-setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void;
+setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void

 设置指定uid应用是否在休眠防火墙的白名单，使用callback方式作为异步方法。

@@ -886,7 +886,7 @@ policy.setDeviceIdleAllowList(Number.parseInt(this.firstParam), Boolean(Number.p

 ## policy.getDeviceIdleAllowList

-getDeviceIdleAllowList(callback: AsyncCallback\<Array\<number>>): void;
+getDeviceIdleAllowList(callback: AsyncCallback\<Array\<number>>): void

 获取休眠模式白名单所包含的uid数组，使用callback方式作为异步方法。

@@ -951,7 +951,7 @@ policy.getDeviceIdleAllowList().then((error, data) {

 ## policy.getBackgroundPolicyByUid

-getBackgroundPolicyByUid(uid: number, callback: AsyncCallback\<NetBackgroundPolicy>): void;
+getBackgroundPolicyByUid(uid: number, callback: AsyncCallback\<NetBackgroundPolicy>): void

 获取指定uid能否访问后台网络，使用callback方式作为异步方法。

@@ -1029,7 +1029,7 @@ policy.getBackgroundPolicyByUid(Number.parseInt(this.firstParam)).then((error, d

 ## policy.resetPolicies

-resetPolicies(iccid: string, callback: AsyncCallback\<void>): void;
+resetPolicies(iccid: string, callback: AsyncCallback\<void>): void

 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用callback方式作为异步方法。

@@ -1111,7 +1111,7 @@ policy.resetPolicies(this.firstParam).then((error, data) {

 ## policy.updateRemindPolicy

-updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback\<void>): void;
+updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback\<void>): void

 更新提醒策略，使用callback方式作为异步方法。

@@ -1198,7 +1198,7 @@ policy.updateRemindPolicy(Number.parseInt(this.netType), this.firstParam, Number

 ## policy.setPowerSaveAllowList

-setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void;
+setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback\<void>): void

 设置指定uid应用是否在省电防火墙的白名单，使用callback方式作为异步方法。

@@ -1283,7 +1283,7 @@ policy.setPowerSaveAllowList(Number.parseInt(this.firstParam), Boolean(Number.pa

 ## policy.getPowerSaveAllowList

-getPowerSaveAllowList(callback: AsyncCallback\<Array\<number>>): void;
+getPowerSaveAllowList(callback: AsyncCallback\<Array\<number>>): void

 获取省电模式白名单所包含的uid数组，使用callback方式作为异步方法。

@@ -1352,7 +1352,7 @@ policy.getPowerSaveAllowList().then((error, data) {

 ### on('netUidPolicyChange')

-on(type: "netUidPolicyChange", callback: Callback\<{ uid: number, policy: NetUidPolicy }>): void;
+on(type: "netUidPolicyChange", callback: Callback\<{ uid: number, policy: NetUidPolicy }>): void

 注册policy发生改变时的回调，使用callback方式作为异步方法。

@@ -1377,7 +1377,7 @@ policy.on('netUidPolicyChange', (data) => {

 ### on('netUidRuleChange')

-on(type: "netUidRuleChange", callback: Callback\<{ uid: number, rule: NetUidRule }>): void;
+on(type: "netUidRuleChange", callback: Callback\<{ uid: number, rule: NetUidRule }>): void

 注册rule发生改变时的回调，使用callback方式作为异步方法。

@@ -1402,7 +1402,7 @@ policy.on('netUidRuleChange', (data) => {

 ### on('netMeteredIfacesChange')

-on(type: "netMeteredIfacesChange", callback: Callback\<Array\<string>>): void;
+on(type: "netMeteredIfacesChange", callback: Callback\<Array\<string>>): void

 注册计量iface发生改变时的回调，使用callback方式作为异步方法。

@@ -1427,7 +1427,7 @@ policy.on('netMeteredIfacesChange', (data) => {

 ### on('netQuotaPolicyChange')

-on(type: "netQuotaPolicyChange", callback: Callback\<Array\<NetQuotaPolicy>>): void;
+on(type: "netQuotaPolicyChange", callback: Callback\<Array\<NetQuotaPolicy>>): void

 注册计量网络策略发生改变时的回调，使用callback方式作为异步方法。

@@ -1452,7 +1452,7 @@ policy.on('netQuotaPolicyChange', (data) => {

 ### on('netBackgroundPolicyChange')

-on(type: "netBackgroundPolicyChange", callback: Callback\<boolean>): void;
+on(type: "netBackgroundPolicyChange", callback: Callback\<boolean>): void

 注册后台网络策略发生改变时的回调，使用callback方式作为异步方法。