chrome.networking.onc

说明

chrome.networking.onc API 用于配置网络连接（移动网络、以太网、VPN 或 Wi-Fi）。此 API 可在自动启动的 ChromeOS 自助服务终端会话中使用。

网络连接配置遵循 Open Network Configuration (ONC) 规范。

注意：大多数字典属性和枚举值都使用 UpperCamelCase（大驼峰式命名法）来匹配 ONC 规范，而不是 JavaScript 的 lowerCamelCase（小驼峰式命名法）惯例。

权限

networking.onc

可用性

Chrome 59 及更高版本 仅限 ChromeOS

类型

ActivationStateType

枚举

“已启用”

“正在激活”

“NotActivated”

“PartiallyActivated”

CaptivePortalStatus

枚举

“未知”

“离线”

“在线”

“Portal”

"ProxyAuthRequired"

CellularProperties

属性

  • ActivationState

    ActivationStateType 可选

    运营商账号激活状态。

  • ActivationType

    字符串（选填）

    移动网络激活类型。

  • AllowRoaming

    布尔值（可选）

    相应网络是否允许漫游。

  • AutoConnect

    布尔值（可选）

    是否应自动连接到移动网络（当在覆盖范围内时）。

  • 家庭

    字符串（选填）

    移动设备技术系列 - CDMA 或 GSM。

  • FirmwareRevision

    字符串（选填）

    移动网络调制解调器中加载的固件修订版本。

  • FoundNetworks

    FoundNetworkProperties[] 可选

    最近一次网络扫描期间发现的网络列表。

  • HardwareRevision

    字符串（选填）

    移动网络调制解调器硬件修订版本。

  • HomeProvider

    CellularProviderProperties 可选

    有关调制解调器中当前安装的 SIM 卡的运营商的信息。

  • 制造商

    字符串（选填）

    移动网络调制解调器制造商。

  • ModelID

    字符串（选填）

    移动网络调制解调器型号 ID。

  • NetworkTechnology

    字符串（选填）

    如果调制解调器已注册到网络，则为当前使用的网络技术。

  • PaymentPortal

    PaymentPortal 可选

    用户可用于注册或修改移动数据流量套餐的在线支付门户。

  • RoamingState

    字符串（选填）

    当前网络上移动网络调制解调器的漫游状态。

  • SIMLockStatus

    SIMLockStatus 可选

    GSM 系列网络的 SIM 卡锁定状态。

  • SIMPresent

    布尔值（可选）

    是否存在 SIM 卡。

  • 扫描

    布尔值（可选）

    Chrome 63 及更高版本

    当正在进行移动网络扫描时，值为 true。

  • ServingOperator

    CellularProviderProperties 可选

    调制解调器当前注册的网络所对应的运营商的相关信息。

  • SignalStrength

    number 可选

    当前网络信号强度。

  • SupportNetworkScan

    布尔值（可选）

    移动网络是否支持扫描。

CellularProviderProperties

属性

  • 代码

    字符串

    移动网络 ID，是网络 MCC（移动设备国家/地区代码）和 MNC（移动网络代码）的简单串联。

  • 国家/地区

    字符串（选填）

    双字母国家/地区代码。

  • 名称

    字符串

    运营商名称。

CellularStateProperties

属性

CertificatePattern

属性

  • EnrollmentURI

    string[] 可选

    如果未找到与相应模式匹配的证书，用户可被定向到的 URI 列表。

  • 颁发者

    IssuerSubjectPattern 可选

    如果已设置，则为应匹配的 X.509 签发者设置所对应的模式。

  • IssuerCARef

    string[] 可选

    证书颁发机构 CA 证书的列表。证书必须由其中一个签名，才能与此模式匹配。

  • 主题

    IssuerSubjectPattern 可选

    如果已设置，则为应与 X.509 主题设置匹配的模式。

ClientCertificateType

枚举

“Ref”

“Pattern”

ConnectionStateType

枚举

“已连接”

“正在连接”

“NotConnected”

DeviceStateProperties

属性

  • SIMLockStatus

    SIMLockStatus 可选

    Chrome 62 及更高版本

    如果 Type = Cellular 且 SIMPresent = True，则为 SIM 卡锁定状态。

  • SIMPresent

    布尔值（可选）

    Chrome 62 及更高版本

    如果设备类型为移动网络，则设置为 SIM 卡存在状态。

  • 扫描

    布尔值（可选）

    设置设备是否已启用。如果设备当前正在扫描，则为 true。

  • 设备的当前状态。

  • 类型

    NetworkType

    与设备关联的网络类型（移动网络、以太网或 Wi-Fi）。

DeviceStateType

枚举

“未初始化”
设备可用，但未初始化。

“已停用”
设备已初始化，但未启用。

“正在启用”
已请求启用状态，但尚未完成。

“已启用”
设备已启用。

“禁止”
设备被禁止。

EAPProperties

属性

  • AnonymousIdentity

    字符串（选填）

  • ClientCertPKCS11Id

    字符串（选填）

    Chrome 60 及更高版本
  • ClientCertPattern

    CertificatePattern 可选

  • ClientCertProvisioningProfileId

    字符串（选填）

    Chrome 93 及更高版本
  • ClientCertRef

    字符串（选填）

  • ClientCertType

    ClientCertificateType

  • 身份

    字符串（选填）

  • 内连接

    字符串（选填）

  • 外连接

    字符串（选填）

    外部 EAP 类型。ONC 需要，但在从 Shill 进行翻译时可能未提供。

  • 密码

    字符串（选填）

  • SaveCredentials

    布尔值（可选）

  • ServerCAPEMs

    string[] 可选

  • ServerCARefs

    string[] 可选

  • SubjectMatch

    ManagedDOMString 可选

    Chrome 60 及更高版本
  • UseProactiveKeyCaching

    布尔值（可选）

  • UseSystemCAs

    布尔值（可选）

EthernetProperties

属性

  • 身份验证

    字符串（选填）

    以太网使用的身份验证。可能的值有 None 和 8021X。

  • AutoConnect

    布尔值（可选）

    以太网是否应自动连接。

  • EAP

    EAPProperties 可选

    网络的 EAP 设置。8021X 身份验证必需。

EthernetStateProperties

属性

FoundNetworkProperties

属性

  • LongName

    字符串（选填）

    网络运营商的长格式名称。

  • NetworkId

    字符串

    广告资源网 ID。

  • ShortName

    字符串（选填）

    网络运营商的短格式名称。

  • 状态

    字符串

    网络可用性。

  • 技术

    字符串

    网络使用的接入技术。

GlobalPolicy

属性

  • AllowOnlyPolicyNetworksToAutoconnect

    布尔值（可选）

    如果为 true，则只有政策网络可以自动连接。默认值为 false。

  • AllowOnlyPolicyNetworksToConnect

    布尔值（可选）

    如果为 true，则只能连接到政策网络，并且无法添加或配置新网络。默认值为 false。

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    布尔值（可选）

    Chrome 70 及更高版本

    如果为 true 且可见网络列表中有受管理的网络，则只能连接到政策网络，并且无法添加或配置新网络。默认值为 false。

  • BlockedHexSSIDs

    string[] 可选

    Chrome 86 及更高版本

    已屏蔽的广告联盟列表。禁止连接到已屏蔽的网络。通过指定明确的网络配置，可以再次解除对网络的屏蔽。默认为空列表。

IPConfigProperties

属性

  • ExcludedRoutes

    string[] 可选

    Chrome 76 及更高版本

    采用 CIDR 表示法的 IP 地址块数组，详见 onc_spec.md。

  • 网关

    字符串（选填）

    用于 IP 配置的网关地址。

  • IPAddress

    字符串（选填）

    连接的 IP 地址。可以是 IPv4 或 IPv6 地址，具体取决于 Type 的值。

  • IncludedRoutes

    string[] 可选

    Chrome 76 及更高版本

    采用 CIDR 表示法的 IP 地址块数组，详见 onc_spec.md。

  • NameServers

    string[] 可选

    用于名称服务器的地址数组。

  • RoutingPrefix

    number 可选

    路由前缀。

  • SearchDomains

    string[] 可选

    Chrome 76 及更高版本

    用于名称解析的字符串数组，详见 onc_spec.md。

  • 类型

    字符串（选填）

    IP 配置类型。可以是 IPv4 或 IPv6。

  • WebProxyAutoDiscoveryUrl

    字符串（选填）

    通过 DHCP 报告的网络代理自动发现的网址。

IPConfigType

枚举

“DHCP”

“静态”

IssuerSubjectPattern

属性

  • CommonName

    字符串（选填）

    如果设置，则为用于匹配证书主题的通用名称的值。

  • 市行政区

    字符串（选填）

    如果设置，则为用于匹配证书主题的通用位置的值。

  • 组织

    字符串（选填）

    如果设置，则为要与证书主题的组织进行匹配的值。至少一个组织应与该值匹配。

  • OrganizationalUnit

    字符串（选填）

    如果设置，则为用于匹配证书主题的组织单元的值。至少一个组织部门应与该值匹配。

ManagedBoolean

属性

  • 有效

    布尔值（可选）

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    布尔值（可选）

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    布尔值（可选）

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    布尔值（可选）

    用户政策提供的属性值。

  • UserSetting

    布尔值（可选）

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedCellularProperties

属性

ManagedDOMString

属性

  • 有效

    字符串（选填）

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    字符串（选填）

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    字符串（选填）

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    字符串（选填）

    用户政策提供的属性值。

  • UserSetting

    字符串（选填）

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedDOMStringList

属性

  • 有效

    string[] 可选

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    string[] 可选

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    string[] 可选

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    string[] 可选

    用户政策提供的属性值。

  • UserSetting

    string[] 可选

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedEthernetProperties

属性

ManagedIPConfigProperties

属性

ManagedIPConfigType

属性

  • 有效

    IPConfigType 可选

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    IPConfigType 可选

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    IPConfigType 可选

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    IPConfigType 可选

    用户政策提供的属性值。

  • UserSetting

    IPConfigType 可选

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedLong

属性

  • 有效

    number 可选

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    number 可选

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    number 可选

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    number 可选

    用户政策提供的属性值。

  • UserSetting

    number 可选

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedManualProxySettings

属性

ManagedProperties

属性

ManagedProxyLocation

属性

ManagedProxySettings

属性

ManagedProxySettingsType

属性

  • 有效

    ProxySettingsType 可选

    网络配置管理器（例如 Shill）当前使用的有效值。

  • DeviceEditable

    布尔值（可选）

    相应属性的 DevicePolicy 是否存在，以及是否允许修改该属性（即，政策是否设置了建议的属性值）。默认为 false。

  • DevicePolicy

    ProxySettingsType 可选

    设备政策提供的属性值。

  • 有效

    字符串（选填）

    有效媒体资源值的确定来源。

  • SharedSetting

    ProxySettingsType 可选

    为设备的所有用户设置的值。仅当 DeviceEditiable 为 true 时提供。

  • UserEditable

    布尔值（可选）

    相应媒体资源是否存在 UserPolicy，以及该政策是否允许修改媒体资源（即，政策设置了建议的媒体资源值）。默认为 false。

  • UserPolicy

    ProxySettingsType 可选

    用户政策提供的属性值。

  • UserSetting

    ProxySettingsType 可选

    登录用户设置的房源价值。仅当 UserEditable 为 true 时提供。

ManagedThirdPartyVPNProperties

属性

ManagedVPNProperties

属性

ManagedWiFiProperties

属性

ManualProxySettings

属性

NetworkConfigProperties

属性

NetworkFilter

属性

  • 已配置

    布尔值（可选）

    如果为 true，则仅包含已配置（已保存）的网络。默认为“false”。

  • 限制

    number 可选

    要返回的网络数量上限。如果未指定，则默认为 1000。使用 0 表示没有限制。

  • networkType

    NetworkType

    要返回的网络类型。

  • 可见

    布尔值（可选）

    如果为 true，则仅包含可见（已连接或在范围内）的网络。默认为“false”。

NetworkProperties

属性

  • 移动网络

    CellularProperties 可选

    对于移动网络，移动网络属性。

  • 可连接

    布尔值（可选）

    网络是否可连接。

  • ConnectionState

    ConnectionStateType 可选

    网络的当前连接状态。

  • ErrorState

    字符串（选填）

    上次记录的网络错误状态。

  • 以太网

    EthernetProperties 可选

    对于以太网，以太网属性。

  • GUID

    字符串

    网络 GUID。

  • IPAddressConfigType

    IPConfigType 可选

    网络的 IP 地址配置类型。

  • IPConfigs

    IPConfigProperties[] 可选IPConfigProperties

    网络的 IP 配置。

  • MacAddress

    字符串（选填）

    网络的 MAC 地址。

  • 按流量计费

    布尔值（可选）

    Chrome 85 及更高版本

    网络是否按流量计费。

  • 名称

    字符串（选填）

    方便用户使用的网络名称。

  • NameServersConfigType

    IPConfigType 可选

    网络所用域名服务器的 IP 配置类型。

  • 优先级

    number 可选

    网络优先级。

  • ProxySettings

    ProxySettings 可选

    网络的代理设置。

  • RestrictedConnectivity

    布尔值（可选）

    对于已连接的网络，网络与互联网的连接是否受限，例如网络是否位于门户后面，或者移动网络是否未激活。

  • SavedIPConfig

    IPConfigProperties 可选

    在应用静态 IP 配置之前从 DHCP 服务器收到的 IP 配置。

  • 来源

    字符串（选填）

    指示网络是否已配置以及配置方式。可能的值包括：

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    “无”与扩展代码生成相冲突，因此我们必须使用字符串来表示“来源”，而不是使用 SourceType 枚举。

  • StaticIPConfig

    IPConfigProperties 可选

    网络的静态 IP 配置。

  • TrafficCounterResetTime

    number 可选

    Chrome 125 及更高版本

    流量计数器的上次重置时间。

  • 类型

    NetworkType

    网络类型。

  • VPN

    VPNProperties 可选

    对于 VPN 网络，网络 VPN 属性。

  • Wi-Fi

    WiFiProperties 可选

    对于 WiFi 网络，网络 WiFi 属性。

NetworkStateProperties

属性

NetworkType

枚举

“全部”

“移动网络”图标

“以太网”

“Tether”

“VPN”

“无线”图标

“WiFi”

PaymentPortal

属性

  • 方法

    字符串

    支付门户要使用的 HTTP 方法。

  • PostData

    字符串（选填）

    要发送到付款门户网站的 POST 数据。除非 Method 为 POST，否则会被忽略。

  • 网址

    字符串（选填）

    付款门户网站网址。

ProxyLocation

属性

  • 主机

    字符串

    代理 IP 地址主机。

  • 端口

    数值

    用于代理的端口。

ProxySettings

属性

  • ExcludeDomains

    string[] 可选

    排除手动代理设置的网域和主机。

  • 手动

    ManualProxySettings（可选）

    手动代理设置 - 仅用于 Manual 代理设置。

  • 政治行动委员会

    字符串（选填）

    代理自动配置文件的网址。

  • 代理设置的类型。

ProxySettingsType

枚举

“直接”

“手动”

“PAC”

“WPAD”

SIMLockStatus

属性

  • LockEnabled

    布尔值

    是否启用了 SIM 卡锁定。

  • LockType

    字符串

    SIM 卡锁的状态 - 可能的值包括 'sim-pin'、'sim-puk' 和 ''。

  • RetriesLeft

    number 可选

    在需要 PUK 码来解锁 SIM 卡之前，允许尝试 PIN 码锁定的次数。

ThirdPartyVPNProperties

属性

  • ExtensionID

    字符串

    第三方 VPN 提供商扩展服务的 ID。

  • ProviderName

    字符串（选填）

    VPN 提供商名称。

VPNProperties

属性

  • AutoConnect

    布尔值（可选）

    是否应自动连接 VPN 网络。

  • 主机

    字符串（选填）

    VPN 主机。

  • 类型

    字符串（选填）

    VPN 类型。由于“L2TP-IPSec”，此值不能是枚举。对于传递给 setProperties 的 NetworkConfigProperties，此参数是可选的，可用于仅设置特定属性。

VPNStateProperties

属性

WiFiProperties

属性

  • AllowGatewayARPPolling

    布尔值（可选）

    自 Chrome 131 起已弃用

    已在 M131 中移除。目前没有有效的 ARP 轮询。

  • AutoConnect

    布尔值（可选）

    是否应在范围内自动连接 Wi-Fi 网络。

  • BSSID

    字符串（选填）

    关联的接入点的 BSSID。

  • EAP

    EAPProperties 可选

    网络 EAP 属性。对于 WEP-8021X 和 WPA-EAP 网络，此参数为必需参数。

  • 频率

    number 可选

    WiFi 服务运行频率（以 MHz 为单位）。对于已连接的网络，指当前连接的网络所使用的频率。否则，为最佳可用 BSS 的频次。

  • FrequencyList

    number[] 可选

    包含 WiFi 网络最近看到的所有工作频段。

  • HexSSID

    字符串（选填）

    网络 SSID 的十六进制编码副本。

  • HiddenSSID

    布尔值（可选）

    网络 SSID 是否会广播。

  • 口令

    字符串（选填）

    Chrome 66 及更高版本

    WEP/WPA/WPA2 连接的密码。此属性只能设置，getProperties 返回的属性不会包含此值。

  • RoamThreshold

    number 可选

    已弃用，已忽略。

  • SSID

    字符串（选填）

    网络 SSID。

  • 安全

    字符串（选填）

    网络安全类型。

  • SignalStrength

    number 可选

    网络信号强度。

WiFiStateProperties

属性

WiMAXProperties

属性

  • AutoConnect

    布尔值（可选）

    网络是否应自动连接。

  • EAP

    EAPProperties 可选

    网络 EAP 属性。

方法

createNetwork()

Promise 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

根据属性创建新的网络配置。如果已存在匹配的已配置网络，则此操作会失败。否则，返回新网络的 GUID。

参数

  • 共享

    布尔值

    如果值为 true，则与其他用户共享此网络配置。

    此选项仅向 Chrome 的 Web 界面公开。* 由应用调用时，false 是唯一允许的值。

  • 用于配置新网络的属性。

  • callback

    函数 可选

    callback 参数如下所示： 

    (result: string) => void

    • 结果

      字符串

返回

  • Promise<string>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
): void

停用与指定网络类型匹配的所有设备。请参阅 enableNetworkType 的备注。

参数

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
): void

启用与指定网络类型匹配的任何设备。请注意，该类型可能表示多种网络类型（例如“无线”）。

参数

forgetNetwork()

Promise 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

通过清除 GUID 为 networkGuid 的网络的所有已配置属性，忘记网络配置。这还可能包括具有匹配标识符（例如 Wi-Fi SSID 和安全性）的任何其他网络。如果不存在此类配置，系统会设置一个错误，并且操作会失败。

在自助服务终端会话中，此方法将无法忘记共享网络配置。

参数

  • networkGuid

    字符串

    要忘记的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getCaptivePortalStatus()

Promise 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

返回与“networkGuid”匹配的网络的强制门户状态。

参数

  • networkGuid

    字符串

    要获取强制门户状态的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    (result: CaptivePortalStatus) => void

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getDeviceStates()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

返回可用网络设备的状态。

参数

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getGlobalPolicy()

Promise 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

获取全局政策属性。这些属性在会话期间预计不会发生变化。

参数

返回

  • Promise<GlobalPolicy>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getManagedProperties()

Promise 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

从以下来源获取具有指定 ID 的网络的合并属性：用户设置、共享设置、用户政策、设备政策和当前有效设置。

参数

  • networkGuid

    字符串

    要获取属性的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    (result: ManagedProperties) => void

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getNetworks()

Promise 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

返回一个网络对象列表，其中包含与 getState 提供的属性相同的属性。系统会提供一个过滤条件，用于指定返回的网络类型并限制网络数量。系统会根据网络的优先级对网络进行排序，已连接或正在连接的网络会列在最前面。

参数

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getProperties()

Promise 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

获取具有指定 ID 的网络的所有属性。包含网络的所有属性（只读值和读/写值）。

参数

  • networkGuid

    字符串

    要获取属性的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    (result: NetworkProperties) => void

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getState()

Promise 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

获取具有指定 ID 的网络的缓存只读属性。此函数旨在提供比 getProperties 更高的性能，后者需要往返查询网络子系统。系统会针对所有网络返回以下属性：GUID、类型、名称、WiFi.Security。为可见网络提供了其他属性：ConnectionState、ErrorState、WiFi.SignalStrength、Cellular.NetworkTechnology、Cellular.ActivationState、Cellular.RoamingState。

参数

返回

  • Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
): void

请求网络子系统扫描新网络并更新 getVisibleNetworks 返回的列表。这只是一个请求：网络子系统可以选择忽略它。如果列表已更新，则会触发 onNetworkListChanged 事件。

参数

  • networkType

    NetworkType 可选

    Chrome 63 及更高版本

    如果提供，则请求特定于该类型的扫描。对于移动网络，如果支持，系统会请求扫描移动网络。

setProperties()

Promise 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

设置 ID 为 networkGuid 的网络的属性。此属性仅对已配置的网络（来源 != None）有效。未配置的可见网络应改用 createNetwork。在自助服务终端会话中，对共享网络调用此方法会失败。

参数

  • networkGuid

    字符串

    要为其设置属性的网络的 GUID。

  • 要设置的属性。

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

startConnect()

Promise 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

开始与具有 networkGuid 的网络建立连接。

参数

  • networkGuid

    字符串

    要连接的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

startDisconnect()

Promise 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

开始断开与 networkGuid 对应的网络连接。

参数

  • networkGuid

    字符串

    要断开连接的网络的 GUID。

  • callback

    函数 可选

    callback 参数如下所示： 

    () => void

返回

  • Promise<void>

    Chrome 125 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

当设备列表发生更改或任何设备状态属性发生更改时触发。

参数

  • callback

    函数

    callback 参数如下所示： 

    () => void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

当网络列表发生变化时触发。发送所有当前网络的 GUID 的完整列表。

参数

  • callback

    函数

    callback 参数如下所示： 

    (changes: string[]) => void

    • 更改

      字符串[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

当任何网络上的属性发生更改时触发。发送属性已更改的网络的 GUID 列表。

参数

  • callback

    函数

    callback 参数如下所示： 

    (changes: string[]) => void

    • 更改

      字符串[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

在完成网络门户检测时触发。发送网络 GUID 和相应的强制门户状态。

参数