Beschreibung
Die chrome.networking.onc
API wird zum Konfigurieren von Netzwerkverbindungen (Mobilfunk, Ethernet, VPN oder WLAN) verwendet. Diese API ist in automatisch gestarteten Chrome OS-Kiosksitzungen verfügbar.
Netzwerkverbindungskonfigurationen werden gemäß der ONC-Spezifikation (Open Network Configuration) angegeben.
HINWEIS: Bei den meisten Wörterbucheigenschaften und enum-Werten wird Großbuchstaben in CamelCase-Schreibweise verwendet, um der ONC-Spezifikation und nicht der JavaScript-CamelCase-Konvention für Kleinbuchstaben zu entsprechen.
Berechtigungen
networking.onc
Verfügbarkeit
Typen
ActivationStateType
Enum
CaptivePortalStatus
Enum
CellularProperties
Attribute
-
ActivationState
ActivationStateType optional
Aktivierungsstatus des Mobilfunkanbieters.
-
ActivationType
String optional
Der Aktivierungstyp des Mobilfunknetzes.
-
AllowRoaming
Boolescher Wert optional
Gibt an, ob Roaming für das Netzwerk erlaubt ist.
-
AutoConnect
Boolescher Wert optional
Legt fest, ob das Mobilfunknetz automatisch verbunden werden soll (wenn in Reichweite).
-
Familie
String optional
Technologiefamilie für Mobilgeräte:
CDMA
oderGSM
. -
FirmwareRevision
String optional
Die auf dem Mobilfunkmodem geladene Firmwareversion.
-
FoundNetworks
FoundNetworkProperties[] optional
Die Liste der Netzwerke, die bei der letzten Netzwerksuche gefunden wurden.
-
HardwareRevision
String optional
Hardwareversion des Mobilfunkmodems.
-
HomeProvider
CellularProviderProperties optional
Informationen zum Anbieter, der die derzeit im Modem eingelegte SIM-Karte ausgestellt hat.
-
Hersteller
String optional
Der Hersteller des Mobilfunkmodems.
-
ModelID
String optional
Modell-ID des Mobilfunkmodems
-
NetworkTechnology
String optional
Ist das Modem in einem Netzwerk registriert, die aktuell verwendete Netzwerktechnologie.
-
PaymentPortal
PaymentPortal optional
Online-Zahlungsportal, über das sich ein Nutzer für einen Tarif für mobile Daten anmelden oder einen Tarif ändern kann
-
RoamingState
String optional
Der Roaming-Status des Mobilfunkmodems im aktuellen Netzwerk.
-
SIMLockStatus
SIMLockStatus optional
Der Status der SIM-Sperre für GSM-Familiennetzwerke.
-
SIMPresent
Boolescher Wert optional
Gibt an, ob eine SIM-Karte vorhanden ist.
-
Wird gescannt
Boolescher Wert optional
Chrome 63 und höher„True“, wenn eine Suche nach Mobilfunknetzen durchgeführt wird.
-
ServingOperator
CellularProviderProperties optional
Informationen zum Betreiber, in dessen Netzwerk das Modem derzeit registriert ist.
-
SignalStrength
Nummer optional
Die aktuelle Signalstärke des Netzwerks.
-
SupportNetworkScan
Boolescher Wert optional
Gibt an, ob das Mobilfunknetz Suchlauf unterstützt.
CellularProviderProperties
Attribute
-
Code
String
ID des Mobilfunknetzes als einfache Verkettung von Kundencentercode (Mobile Country Code) und MNC (Mobile Network Code)
-
Land
String optional
Der aus zwei Buchstaben bestehende Ländercode.
-
Name
String
Der Name des Operators.
CellularStateProperties
Attribute
-
ActivationState
ActivationStateType optional
Weitere Informationen finden Sie unter
CellularProperties.ActivationState
. -
NetworkTechnology
String optional
Weitere Informationen finden Sie unter
CellularProperties.NetworkTechnology
. -
RoamingState
String optional
Weitere Informationen finden Sie unter
CellularProperties.RoamingState
. -
SIMPresent
Boolescher Wert optional
Weitere Informationen finden Sie unter
CellularProperties.SIMPresent
. -
SignalStrength
Nummer optional
Weitere Informationen finden Sie unter
CellularProperties.SignalStrength
.
CertificatePattern
Attribute
-
EnrollmentURI
string[] optional
Liste der URIs, an die der Nutzer weitergeleitet werden kann, falls keine Zertifikate gefunden werden, die diesem Muster entsprechen.
-
Aussteller
IssuerSubjectPattern optional
Muster, mit dem die X.509-Ausstellereinstellungen abgeglichen werden sollen, falls festgelegt.
-
IssuerCARef
string[] optional
Liste der CA-Zertifikate des Zertifikatausstellers. Ein Zertifikat muss von einem von ihnen signiert sein, damit dieses Muster übereinstimmt.
-
Betreff
IssuerSubjectPattern optional
Falls festgelegt, Muster, mit dem die X.509-Motiveinstellungen abgeglichen werden sollen.
ClientCertificateType
Enum
ConnectionStateType
Enum
DeviceStateProperties
Attribute
-
SIMLockStatus
SIMLockStatus optional
Chrome 62 und höherStatus der SIM-Sperre, wenn Typ = Mobilfunknetz und SIMPresent = True.
-
SIMPresent
Boolescher Wert optional
Chrome 62 und höherWenn der Gerätetyp „Mobilfunk“ ist, wird der Status auf den aktuellen SIM-Status festgelegt.
-
Wird gescannt
Boolescher Wert optional
Festlegen, ob das Gerät aktiviert ist „True“, wenn das Gerät gerade scannt.
-
Status
Der aktuelle Status des Geräts.
-
Typ
Der Netzwerktyp, der dem Gerät zugeordnet ist (Mobilfunknetz, Ethernet oder WLAN).
DeviceStateType
Enum
„Nicht initialisiert“
Das Gerät ist verfügbar, aber nicht initialisiert.
„Deaktiviert“
Das Gerät wurde initialisiert, aber nicht aktiviert.
„Wird aktiviert“
Der Status „Aktiviert“ wurde angefordert, ist aber noch nicht abgeschlossen.
„Aktiviert“
Das Gerät ist aktiviert.
„Verboten“
Das Gerät ist nicht zulässig.
EAPProperties
Attribute
-
AnonymousIdentity
String optional
-
ClientCertPKCS11Id
String optional
Chrome 60 oder höher -
ClientCertPattern
CertificatePattern optional
-
ClientCertProvisioningProfileId
String optional
Chrome 93 und höher -
ClientCertRef
String optional
-
ClientCertType
-
Identität
String optional
-
Inner Join
String optional
-
Außen
String optional
Der äußere EAP-Typ. Von ONC gefordert, jedoch möglicherweise nicht bei Übersetzungen aus Shill.
-
Passwort
String optional
-
SaveCredentials
Boolescher Wert optional
-
ServerCAPEMs
string[] optional
-
ServerCARefs
string[] optional
-
SubjectMatch
ManagedDOMString optional
Chrome 60 oder höher -
UseProactiveKeyCaching
Boolescher Wert optional
-
UseSystemCAs
Boolescher Wert optional
EthernetProperties
Attribute
-
Authentifizierung
String optional
Die vom Ethernet-Netzwerk verwendete Authentifizierung. Die möglichen Werte sind
None
und8021X
. -
AutoConnect
Boolescher Wert optional
Gibt an, ob das Ethernet-Netzwerk automatisch verbunden werden soll.
-
EAP
EAPProperties optional
EAP-Einstellungen des Netzwerks. Erforderlich für 8021X-Authentifizierung.
EthernetStateProperties
Attribute
-
Authentifizierung
String
Weitere Informationen finden Sie unter
EthernetProperties.Authentication
.
FoundNetworkProperties
Attribute
-
LongName
String optional
Der lange Name des Netzbetreibers.
-
NetworkId
String
Netzwerk-ID.
-
ShortName
String optional
Der Kurzformatname des Netzbetreibers.
-
Status
String
Netzwerkverfügbarkeit.
-
Technologie
String
Auf die vom Netzwerk verwendete Technologie zugreifen
GlobalPolicy
Attribute
-
AllowOnlyPolicyNetworksToAutoconnect
Boolescher Wert optional
Wenn „true“ festgelegt ist, können nur Richtliniennetzwerke automatisch eine Verbindung herstellen. Die Standardeinstellung ist "false".
-
AllowOnlyPolicyNetworksToConnect
Boolescher Wert optional
Wenn „true“ festgelegt ist, dürfen nur Richtliniennetzwerke verbunden werden und es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".
-
AllowOnlyPolicyNetworksToConnectIfAvailable
Boolescher Wert optional
Chrome 70 oder höherWenn „true“ festgelegt ist und ein verwaltetes Netzwerk in der Liste der sichtbaren Netzwerke verfügbar ist, können nur Richtliniennetzwerke verbunden werden und es können keine neuen Netzwerke hinzugefügt oder konfiguriert werden. Die Standardeinstellung ist "false".
-
BlockedHexSSIDs
string[] optional
Chrome 86 und höherListe der blockierten Netzwerke. Verbindungen zu blockierten Netzwerken sind unzulässig. Die Blockierung von Netzwerken kann wieder aufgehoben werden, indem eine explizite Netzwerkkonfiguration angegeben wird. Die Standardeinstellung ist eine leere Liste.
IPConfigProperties
Attribute
-
ExcludedRoutes
string[] optional
Chrome 76 und höherArray von IP-Blöcken in CIDR-Notation, weitere Informationen finden Sie unter onc_spec.md.
-
Gateway
String optional
Gatewayadresse, die für die IP-Konfiguration verwendet wird.
-
IPAddress
String optional
Die IP-Adresse für eine Verbindung. Kann eine IPv4- oder IPv6-Adresse sein, abhängig vom Wert von
Type
. -
IncludedRoutes
string[] optional
Chrome 76 und höherArray von IP-Blöcken in CIDR-Notation, weitere Informationen finden Sie unter onc_spec.md.
-
NameServers
string[] optional
Array von Adressen, die für Nameserver verwendet werden.
-
RoutingPrefix
Nummer optional
Das Routingpräfix.
-
SearchDomains
string[] optional
Chrome 76 und höherString-Array für die Namensauflösung, weitere Informationen siehe onc_spec.md
-
Typ
String optional
Der IP-Konfigurationstyp. Kann
IPv4
oderIPv6
sein. -
WebProxyAutoDiscoveryUrl
String optional
Die URL für WEb Proxy Auto-Discovery, wie über DHCP gemeldet.
IPConfigType
Enum
IssuerSubjectPattern
Attribute
-
CommonName
String optional
Falls dieser Wert festgelegt ist, der mit dem allgemeinen Namen des Zertifikatsinhabers abgeglichen werden soll.
-
Ort
String optional
Falls festgelegt, der Wert, mit dem der gemeinsame Standort des Zertifikatsinhabers abgeglichen werden soll.
-
Organisation
String optional
Falls festgelegt, der Wert, mit dem die Organisationen des Zertifikatsinhabers abgeglichen werden sollen. Es muss mindestens eine Organisation mit dem Wert übereinstimmen.
-
OrganizationalUnit
String optional
Falls festgelegt, der Wert, mit dem die Organisationseinheiten des Zertifikatsinhabers abgeglichen werden sollen. Mindestens eine Organisationseinheit muss mit dem Wert übereinstimmen.
ManagedBoolean
Attribute
-
Aktiv
Boolescher Wert optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
Boolescher Wert optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
Boolescher Wert optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
Boolescher Wert optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
Boolescher Wert optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedCellularProperties
Attribute
-
ActivationState
ActivationStateType optional
Weitere Informationen finden Sie unter
CellularProperties.ActivationState
. -
ActivationType
String optional
Weitere Informationen finden Sie unter
CellularProperties.ActivationType
. -
AllowRoaming
Boolescher Wert optional
Weitere Informationen finden Sie unter
CellularProperties.AllowRoaming
. -
AutoConnect
ManagedBoolean optional
Weitere Informationen finden Sie unter
CellularProperties.AutoConnect
. -
Familie
String optional
Weitere Informationen finden Sie unter
CellularProperties.Family
. -
FirmwareRevision
String optional
Weitere Informationen finden Sie unter
CellularProperties.FirmwareRevision
. -
FoundNetworks
FoundNetworkProperties[] optional
Weitere Informationen finden Sie unter
CellularProperties.FoundNetworks
. -
HardwareRevision
String optional
Weitere Informationen finden Sie unter
CellularProperties.HardwareRevision
. -
HomeProvider
CellularProviderProperties[] optional
Weitere Informationen finden Sie unter
CellularProperties.HomeProvider
. -
Hersteller
String optional
Weitere Informationen finden Sie unter
CellularProperties.Manufacturer
. -
ModelID
String optional
Weitere Informationen finden Sie unter
CellularProperties.ModelID
. -
NetworkTechnology
String optional
Weitere Informationen finden Sie unter
CellularProperties.NetworkTechnology
. -
PaymentPortal
PaymentPortal optional
Weitere Informationen finden Sie unter
CellularProperties.PaymentPortal
. -
RoamingState
String optional
Weitere Informationen finden Sie unter
CellularProperties.RoamingState
. -
SIMLockStatus
SIMLockStatus optional
Weitere Informationen finden Sie unter
CellularProperties.SIMLockStatus
. -
SIMPresent
Boolescher Wert optional
Weitere Informationen finden Sie unter
CellularProperties.SIMPresent
. -
Wird gescannt
Boolescher Wert optional
Chrome 63 und höherWeitere Informationen finden Sie unter
CellularProperties.Scanning
. -
ServingOperator
CellularProviderProperties optional
Weitere Informationen finden Sie unter
CellularProperties.ServingOperator
. -
SignalStrength
Nummer optional
Weitere Informationen finden Sie unter
CellularProperties.SignalStrength
. -
SupportNetworkScan
Boolescher Wert optional
Weitere Informationen finden Sie unter
CellularProperties.SupportNetworkScan
.
ManagedDOMString
Attribute
-
Aktiv
String optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
String optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
String optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
String optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
String optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedDOMStringList
Attribute
-
Aktiv
string[] optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
string[] optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
string[] optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
string[] optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
string[] optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedEthernetProperties
Attribute
-
Authentifizierung
ManagedDOMString optional
Weitere Informationen finden Sie unter
EthernetProperties.Authentication
. -
AutoConnect
ManagedBoolean optional
Weitere Informationen finden Sie unter
EthernetProperties.AutoConnect
.
ManagedIPConfigProperties
Attribute
-
Gateway
ManagedDOMString optional
Weitere Informationen finden Sie unter
IPConfigProperties.Gateway
. -
IPAddress
ManagedDOMString optional
Weitere Informationen finden Sie unter
IPConfigProperties.IPAddress
. -
NameServers
ManagedDOMStringList optional
Weitere Informationen finden Sie unter
IPConfigProperties.NameServers
. -
RoutingPrefix
ManagedLong optional
Weitere Informationen finden Sie unter
IPConfigProperties.RoutingPrefix
. -
Typ
ManagedDOMString optional
Weitere Informationen finden Sie unter
IPConfigProperties.Type
. -
WebProxyAutoDiscoveryUrl
ManagedDOMString optional
Weitere Informationen finden Sie unter
IPConfigProperties.WebProxyAutoDiscoveryUrl
.
ManagedIPConfigType
Attribute
-
Aktiv
IPConfigType optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
IPConfigType optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
IPConfigType optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
IPConfigType optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
IPConfigType optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedLong
Attribute
-
Aktiv
Nummer optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
Nummer optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
Nummer optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
Nummer optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
Nummer optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedManualProxySettings
Attribute
-
FTPProxy
ManagedProxyLocation optional
Weitere Informationen finden Sie unter
ManualProxySettings.FTPProxy
. -
HTTPProxy
ManagedProxyLocation optional
Weitere Informationen finden Sie unter
ManualProxySettings.HTTPProxy
. -
SOCKEN
ManagedProxyLocation optional
Weitere Informationen finden Sie unter
ManualProxySettings.SOCKS
. -
SecureHTTPProxy
ManagedProxyLocation optional
Weitere Informationen finden Sie unter
ManualProxySettings.SecureHTTPProxy
.
ManagedProperties
Attribute
-
Mobilfunk
ManagedCellularProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Cellular
. -
Verbindung möglich
Boolescher Wert optional
Weitere Informationen finden Sie unter
NetworkProperties.Connectable
. -
ConnectionState
ConnectionStateType optional
Weitere Informationen finden Sie unter
NetworkProperties.ConnectionState
. -
ErrorState
String optional
Weitere Informationen finden Sie unter
NetworkProperties.ErrorState
. -
Ethernet
ManagedEthernetProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Ethernet
. -
GUID
String
Weitere Informationen finden Sie unter
NetworkProperties.GUID
. -
IPAddressConfigType
ManagedIPConfigType optional
Weitere Informationen finden Sie unter
NetworkProperties.IPAddressConfigType
. -
IPConfigs
IPConfigProperties[] optional
Weitere Informationen finden Sie unter
NetworkProperties.IPConfigs
. -
MacAddress
String optional
Weitere Informationen finden Sie unter
NetworkProperties.MacAddress
. -
Kostenpflichtig
ManagedBoolean optional
Chrome 85 und höherWeitere Informationen finden Sie unter
NetworkProperties.Metered
. -
Name
ManagedDOMString optional
Weitere Informationen finden Sie unter
NetworkProperties.Name
. -
NameServersConfigType
ManagedIPConfigType optional
Weitere Informationen finden Sie unter
NetworkProperties.NameServersConfigType
. -
Priorität
ManagedLong optional
Weitere Informationen finden Sie unter
NetworkProperties.Priority
. -
ProxySettings
ManagedProxySettings optional
Weitere Informationen finden Sie unter
NetworkProperties.ProxySettings
. -
RestrictedConnectivity
Boolescher Wert optional
Weitere Informationen finden Sie unter
NetworkProperties.RestrictedConnectivity
. -
SavedIPConfig
IPConfigProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.SavedIPConfig
. -
Quelle
String optional
Weitere Informationen finden Sie unter
NetworkProperties.Source
. -
StaticIPConfig
ManagedIPConfigProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.StaticIPConfig
. -
TrafficCounterResetTime
Nummer optional
Chrome 125 oder höherWeitere Informationen finden Sie unter
NetworkProperties.TrafficCounterResetTime
. -
Typ
Weitere Informationen finden Sie unter
NetworkProperties.Type
. -
VPN
ManagedVPNProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.VPN
. -
WiFi
ManagedWiFiProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.WiFi
.
ManagedProxyLocation
Attribute
-
Host
Weitere Informationen finden Sie unter
ProxyLocation.Host
. -
Port
Weitere Informationen finden Sie unter
ProxyLocation.Port
.
ManagedProxySettings
Attribute
-
ExcludeDomains
ManagedDOMStringList optional
Weitere Informationen finden Sie unter
ProxySettings.ExcludeDomains
. -
Manuell
ManagedManualProxySettings optional
Weitere Informationen finden Sie unter
ProxySettings.Manual
. -
PAC (Political Action Committee)
ManagedDOMString optional
Weitere Informationen finden Sie unter
ProxySettings.PAC
. -
Weitere Informationen finden Sie unter
ProxySettings.Type
.
ManagedProxySettingsType
Attribute
-
Aktiv
ProxySettingsType optional
Der aktive Wert, der derzeit vom Netzwerkkonfigurationsmanager verwendet wird (z.B. Shill).
-
DeviceEditable
Boolescher Wert optional
Gibt an, ob eine DevicePolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
DevicePolicy
ProxySettingsType optional
Der von der Geräterichtlinie bereitgestellte Eigenschaftswert.
-
Wirksam
String optional
Die Quelle, aus der der effektive Property-Wert ermittelt wurde.
-
ProxySettingsType optional
Der Wert, der für alle Nutzer des Geräts festgelegt ist. Wird nur angegeben, wenn
DeviceEditiable
den Werttrue
hat. -
UserEditable
Boolescher Wert optional
Gibt an, ob eine UserPolicy für die Eigenschaft existiert und das Bearbeiten der Eigenschaft ermöglicht (d.h. der gemäß der Richtlinie festgelegte empfohlene Eigenschaftswert). Die Standardeinstellung ist
false
. -
UserPolicy
ProxySettingsType optional
Der von der Nutzerrichtlinie bereitgestellte Eigenschaftswert.
-
UserSetting
ProxySettingsType optional
Der vom angemeldeten Nutzer festgelegte Eigenschaftswert Wird nur angegeben, wenn
UserEditable
den Werttrue
hat.
ManagedThirdPartyVPNProperties
Attribute
-
ExtensionID
Weitere Informationen finden Sie unter
ThirdPartyVPNProperties.ExtensionID
. -
ProviderName
String optional
Weitere Informationen finden Sie unter
ThirdPartyVPNProperties.ProviderName
.
ManagedVPNProperties
Attribute
-
AutoConnect
ManagedBoolean optional
Weitere Informationen finden Sie unter
VPNProperties.AutoConnect
. -
Host
ManagedDOMString optional
Weitere Informationen finden Sie unter
VPNProperties.Host
. -
Typ
ManagedDOMString optional
Weitere Informationen finden Sie unter
VPNProperties.Type
.
ManagedWiFiProperties
Attribute
-
AllowGatewayARPPolling
ManagedBoolean optional
Weitere Informationen finden Sie unter
WiFiProperties.AllowGatewayARPPolling
. -
AutoConnect
ManagedBoolean optional
Weitere Informationen finden Sie unter
WiFiProperties.AutoConnect
. -
BSSID
String optional
Weitere Informationen finden Sie unter
WiFiProperties.BSSID
. -
Frequenz
Nummer optional
Weitere Informationen finden Sie unter
WiFiProperties.Frequency
. -
FrequencyList
nummer[] optional
Weitere Informationen finden Sie unter
WiFiProperties.FrequencyList
. -
HexSSID
ManagedDOMString optional
Weitere Informationen finden Sie unter
WiFiProperties.HexSSID
. -
HiddenSSID
ManagedBoolean optional
Weitere Informationen finden Sie unter
WiFiProperties.HiddenSSID
. -
RoamThreshold
ManagedLong optional
Eingestellt, ignoriert. Weitere Informationen finden Sie unter
WiFiProperties.RoamThreshold
. -
SSID
ManagedDOMString optional
Weitere Informationen finden Sie unter
WiFiProperties.SSID
. -
Sicherheit
Weitere Informationen finden Sie unter
WiFiProperties.Security
. -
SignalStrength
Nummer optional
Weitere Informationen finden Sie unter
WiFiProperties.SignalStrength
.
ManualProxySettings
Attribute
-
FTPProxy
ProxyLocation optional
Einstellungen für FTP-Proxy.
-
HTTPProxy
ProxyLocation optional
Einstellungen für HTTP-Proxy.
-
SOCKEN
ProxyLocation optional
Einstellungen für den SOCKS-Proxy.
-
SecureHTTPProxy
ProxyLocation optional
Einstellungen für den sicheren HTTP-Proxy.
NetworkConfigProperties
Attribute
-
Mobilfunk
CellularProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Cellular
. -
Ethernet
EthernetProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Ethernet
. -
GUID
String optional
Weitere Informationen finden Sie unter
NetworkProperties.GUID
. -
IPAddressConfigType
IPConfigType optional
Weitere Informationen finden Sie unter
NetworkProperties.IPAddressConfigType
. -
Name
String optional
Weitere Informationen finden Sie unter
NetworkProperties.Name
. -
NameServersConfigType
IPConfigType optional
Weitere Informationen finden Sie unter
NetworkProperties.NameServersConfigType
. -
Priorität
Nummer optional
Weitere Informationen finden Sie unter
NetworkProperties.Priority
. -
Typ
NetworkType optional
Weitere Informationen finden Sie unter
NetworkProperties.Type
. -
VPN
VPNProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.VPN
. -
WiFi
WiFiProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.WiFi
. -
WiMAX
WiMAXProperties optional
Veraltet.
NetworkFilter
Attribute
-
konfiguriert
Boolescher Wert optional
Bei „true“ werden nur konfigurierte (gespeicherte) Netzwerke einbezogen. Die Standardeinstellung ist „false“.
-
Limit
Nummer optional
Maximale Anzahl von Netzwerken, die zurückgegeben werden sollen. Wenn keine Angabe gemacht wird, ist der Standardwert 1.000. Verwenden Sie 0, wenn Sie keine Begrenzung verwenden möchten.
-
networkType
Der Netzwerktyp, der zurückgegeben werden soll.
-
sichtbar
Boolescher Wert optional
Wenn dieser Wert „true“ ist, werden nur sichtbare Netzwerke einbezogen, die physisch verbunden oder in Reichweite sind. Die Standardeinstellung ist „false“.
NetworkProperties
Attribute
-
Mobilfunk
CellularProperties optional
Bei Mobilfunknetzen: Eigenschaften von Mobilfunknetzen.
-
Verbindung möglich
Boolescher Wert optional
Gibt an, ob das Netzwerk verbunden werden kann.
-
ConnectionState
ConnectionStateType optional
Der aktuelle Verbindungsstatus des Netzwerks.
-
ErrorState
String optional
Der letzte aufgezeichnete Netzwerkfehlerstatus.
-
Ethernet
EthernetProperties optional
Bei Ethernet-Netzwerken die Ethernet-Netzwerkeigenschaften.
-
GUID
String
Die Netzwerk-GUID.
-
IPAddressConfigType
IPConfigType optional
Der Konfigurationstyp der IP-Adresse des Netzwerks.
-
IPConfigs
IPConfigProperties[] optional
Die IP-Konfiguration des Netzwerks.
-
MacAddress
String optional
Die MAC-Adresse des Netzwerks.
-
Kostenpflichtig
Boolescher Wert optional
Chrome 85 und höherGibt an, ob das Netzwerk kostenpflichtig ist.
-
Name
String optional
Ein nutzerfreundlicher Netzwerkname.
-
NameServersConfigType
IPConfigType optional
Der IP-Konfigurationstyp für die Nameserver, die vom Netzwerk verwendet werden.
-
Priorität
Nummer optional
Die Netzwerkpriorität.
-
ProxySettings
ProxySettings optional
Die Proxy-Einstellungen des Netzwerks.
-
RestrictedConnectivity
Boolescher Wert optional
Gibt an, ob bei einem verbundenen Netzwerk die Netzwerkverbindung zum Internet eingeschränkt ist, z.B. wenn sich das Netzwerk hinter einem Portal befindet oder kein Mobilfunknetz aktiviert ist.
-
SavedIPConfig
IPConfigProperties optional
IP-Konfiguration, die vor dem Anwenden der statischen IP-Konfiguration vom DHCP-Server empfangen wurde.
-
Quelle
String optional
Gibt an, ob und wie das Netzwerk konfiguriert ist. Folgende Werte sind möglich:
Device
DevicePolicy
User
UserPolicy
None
„None“ steht in Konflikt mit der Erweiterungscodegenerierung. Daher müssen wir für „Source“ einen String anstelle einer SourceType-Enum verwenden.
-
StaticIPConfig
IPConfigProperties optional
Die statische IP-Konfiguration des Netzwerks.
-
TrafficCounterResetTime
Nummer optional
Chrome 125 oder höherWann die Traffic-Zähler zuletzt zurückgesetzt wurden.
-
Typ
Der Netzwerktyp.
-
VPN
VPNProperties optional
Bei VPN-Netzwerken die Netzwerk-VPN-Eigenschaften.
-
WiFi
WiFiProperties optional
Bei WLAN-Netzwerken die Netzwerk-WLAN-Eigenschaften.
NetworkStateProperties
Attribute
-
Mobilfunk
CellularStateProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Cellular
. -
Verbindung möglich
Boolescher Wert optional
Weitere Informationen finden Sie unter
NetworkProperties.Connectable
. -
ConnectionState
ConnectionStateType optional
Weitere Informationen finden Sie unter
NetworkProperties.ConnectionState
. -
ErrorState
String optional
Weitere Informationen finden Sie unter
NetworkProperties.ErrorState
. -
Ethernet
EthernetStateProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.Ethernet
. -
GUID
String
Weitere Informationen finden Sie unter
NetworkProperties.GUID
. -
Name
String optional
Weitere Informationen finden Sie unter
NetworkProperties.Name
. -
Priorität
Nummer optional
Weitere Informationen finden Sie unter
NetworkProperties.Priority
. -
Quelle
String optional
Weitere Informationen finden Sie unter
NetworkProperties.Source
. -
Typ
Weitere Informationen finden Sie unter
NetworkProperties.Type
. -
VPN
VPNStateProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.VPN
. -
WiFi
WiFiStateProperties optional
Weitere Informationen finden Sie unter
NetworkProperties.WiFi
.
NetworkType
Enum
"Ethernet"
PaymentPortal
Attribute
-
Methode
String
Die für das Zahlungsportal zu verwendende HTTP-Methode.
-
PostData
String optional
Die Post-Daten, die an das Zahlungsportal gesendet werden sollen. Wird ignoriert, außer
Method
istPOST
. -
URL
String optional
Die URL des Zahlungsportals.
ProxyLocation
Attribute
-
Host
String
Der Proxy-IP-Adresshost.
-
Port
Zahl
Der für den Proxy zu verwendende Port.
ProxySettings
Attribute
-
ExcludeDomains
string[] optional
Domains und Hosts, für die manuelle Proxyeinstellungen ausgeschlossen sind.
-
Manuell
ManualProxySettings optional
Manuelle Proxy-Einstellungen – wird nur für
Manual
-Proxy-Einstellungen verwendet. -
PAC (Political Action Committee)
String optional
URL für die Datei zur automatischen Konfiguration des Proxys.
-
Der Typ der Proxy-Einstellungen.
ProxySettingsType
Enum
"PAC"
SIMLockStatus
Attribute
-
LockEnabled
boolean
Gibt an, ob die SIM-Sperre aktiviert ist.
-
LockType
String
Status der SIM-Sperre. Mögliche Werte sind
'sim-pin'
,'sim-puk'
und''
. -
RetriesLeft
Nummer optional
Anzahl der erlaubten Versuche, die SIM-Karte zu sperren, bevor der PUK zum Entsperren erforderlich ist.
ThirdPartyVPNProperties
Attribute
-
ExtensionID
String
ID der Erweiterung des Drittanbieter-VPN-Anbieters.
-
ProviderName
String optional
Der Name des VPN-Anbieters.
VPNProperties
Attribute
-
AutoConnect
Boolescher Wert optional
Legt fest, ob das VPN-Netzwerk automatisch verbunden werden soll.
-
Host
String optional
Der VPN-Host.
-
Typ
String optional
Der VPN-Typ. Dies kann aufgrund von „L2TP-IPSec“ keine Aufzählung sein. Dies ist optional für „NetworkConfigProperties“, die an „setProperties“ übergeben werden und mit denen nur bestimmte Attribute festgelegt werden können.
VPNStateProperties
Attribute
-
Typ
String
Weitere Informationen finden Sie unter
VPNProperties.Type
.
WiFiProperties
Attribute
-
AllowGatewayARPPolling
Boolescher Wert optional
Gibt an, ob ARP-Abfragen des Standardgateways zulässig sind. Der Standardwert ist „true“.
-
AutoConnect
Boolescher Wert optional
Gibt an, ob das WLAN-Netzwerk automatisch verbunden werden soll, wenn es sich in Reichweite befindet.
-
BSSID
String optional
Die BSSID des zugehörigen Zugangspunkts.
-
EAP
EAPProperties optional
Die EAP-Eigenschaften des Netzwerks. Erforderlich für
WEP-8021X
- undWPA-EAP
-Netzwerke. -
Frequenz
Nummer optional
Betriebsfrequenz des WLAN-Dienstes in MHz. Bei verbundenen Netzwerken die aktuelle Frequenz, mit der das Netzwerk verbunden ist. Andernfalls die Häufigkeit des besten verfügbaren BSS.
-
FrequencyList
nummer[] optional
Enthält die gesamte Betriebsfrequenz, die zuletzt für das WLAN ermittelt wurde.
-
HexSSID
String optional
HEX-codierte Kopie der Netzwerk-SSID.
-
HiddenSSID
Boolescher Wert optional
Gibt an, ob die Netzwerk-SSID übertragen wird.
-
Passphrase
String optional
Chrome 66 und höherDie Passphrase für WEP-/WPA-/WPA2-Verbindungen. Dieses Attribut kann nur festgelegt werden – Eigenschaften, die von
getProperties
zurückgegeben werden, enthalten diesen Wert nicht. -
RoamThreshold
Nummer optional
Eingestellt, ignoriert.
-
SSID
String optional
Die Netzwerk-SSID.
-
Sicherheit
String optional
Der Netzwerksicherheitstyp.
-
SignalStrength
Nummer optional
Die Signalstärke des Netzwerks.
WiFiStateProperties
Attribute
-
BSSID
String optional
Weitere Informationen finden Sie unter
WiFiProperties.BSSID
. -
Frequenz
Nummer optional
Weitere Informationen finden Sie unter
WiFiProperties.Frequency
. -
HexSSID
String optional
Chrome 62 und höherWeitere Informationen finden Sie unter
WiFiProperties.HexSSID
. -
SSID
String optional
Chrome 62 und höherWeitere Informationen finden Sie unter
WiFiProperties.SSID
. -
Sicherheit
String
Weitere Informationen finden Sie unter
WiFiProperties.Security
. -
SignalStrength
Nummer optional
Weitere Informationen finden Sie unter
WiFiProperties.SignalStrength
.
WiMAXProperties
Attribute
-
AutoConnect
Boolescher Wert optional
Gibt an, ob das Netzwerk automatisch verbunden werden soll.
-
EAP
EAPProperties optional
Die EAP-Eigenschaften des Netzwerks.
Methoden
createNetwork()
chrome.networking.onc.createNetwork(
shared: boolean,
properties: NetworkConfigProperties,
callback?: function,
)
Erstellt eine neue Netzwerkkonfiguration aus Properties. Wenn bereits ein passendes konfiguriertes Netzwerk vorhanden ist, schlägt der Vorgang fehl. Andernfalls wird die GUID des neuen Netzwerks zurückgegeben.
Parameter
-
boolean
Wenn
true
, geben Sie diese Netzwerkkonfiguration für andere Nutzer frei.Diese Option ist nur in der Web-UI von Chrome verfügbar.* Wenn sie von Apps aufgerufen werden, ist
false
der einzige zulässige Wert. -
Properties
Die Eigenschaften, mit denen das neue Netzwerk konfiguriert werden soll.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: string) => void
-
Ergebnis
String
-
Returns
-
Versprechen<string>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
disableNetworkType()
chrome.networking.onc.disableNetworkType(
networkType: NetworkType,
)
Deaktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Siehe Hinweis für enableNetworkType
.
Parameter
-
networkType
Der Netzwerktyp, der deaktiviert werden soll.
enableNetworkType()
chrome.networking.onc.enableNetworkType(
networkType: NetworkType,
)
Aktiviert alle Geräte, die dem angegebenen Netzwerktyp entsprechen. Hinweis: Der Typ kann für mehrere Netzwerktypen stehen (z.B. „Drahtlos“).
Parameter
-
networkType
Der zu aktivierende Netzwerktyp.
forgetNetwork()
chrome.networking.onc.forgetNetwork(
networkGuid: string,
callback?: function,
)
Entfernt eine Netzwerkkonfiguration, indem alle konfigurierten Eigenschaften für das Netzwerk mit der GUID networkGuid
gelöscht werden. Dies kann auch andere Netzwerke mit übereinstimmenden Kennungen umfassen (z.B. WLAN-SSID und Sicherheit). Ist keine solche Konfiguration vorhanden, wird ein Fehler ausgegeben und der Vorgang schlägt fehl.
In Kiosksitzungen können bei dieser Methode freigegebene Netzwerkkonfigurationen nicht entfernt werden.
Parameter
-
networkGuid
String
Die GUID des zu entfernenden Netzwerks.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getCaptivePortalStatus()
chrome.networking.onc.getCaptivePortalStatus(
networkGuid: string,
callback?: function,
)
Gibt den Captive-Portal-Status für das Netzwerk zurück, das mit „networkGuid“ übereinstimmt.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, für das der Captive Portal-Status abgerufen werden soll.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: CaptivePortalStatus) => void
-
Ergebnis
-
Returns
-
Promise<CaptivePortalStatus>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getDeviceStates()
chrome.networking.onc.getDeviceStates(
callback?: function,
)
Gibt Status verfügbarer Netzwerkgeräte zurück.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: DeviceStateProperties[]) => void
-
Ergebnis
-
Returns
-
Promise<DeviceStateProperties[]>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getGlobalPolicy()
chrome.networking.onc.getGlobalPolicy(
callback?: function,
)
Ruft die globalen Richtlinieneigenschaften ab. Diese Eigenschaften ändern sich im Verlauf einer Sitzung normalerweise nicht.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: GlobalPolicy) => void
-
Ergebnis
-
Returns
-
Promise<GlobalPolicy>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getManagedProperties()
chrome.networking.onc.getManagedProperties(
networkGuid: string,
callback?: function,
)
Ruft die zusammengeführten Eigenschaften des Netzwerks mit der ID networkGuid aus den Quellen ab: Nutzereinstellungen, freigegebene Einstellungen, Nutzerrichtlinien, Geräterichtlinien und die derzeit aktiven Einstellungen.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, für das Properties abgerufen werden sollen.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: ManagedProperties) => void
-
Ergebnis
-
Returns
-
Promise<ManagedProperties>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getNetworks()
chrome.networking.onc.getNetworks(
filter: NetworkFilter,
callback?: function,
)
Gibt eine Liste von Netzwerkobjekten mit denselben Eigenschaften zurück, die von getState
bereitgestellt werden. Ein Filter wird bereitgestellt, um den Typ der zurückgegebenen Netzwerke anzugeben und die Anzahl der Netzwerke zu begrenzen. Die Netzwerke werden vom System nach Priorität sortiert, wobei verbundene oder verbundene Netzwerke zuerst aufgeführt werden.
Parameter
-
Filter
Beschreibt, welche Netzwerke zurückgegeben werden sollen.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: NetworkStateProperties[]) => void
-
Ergebnis
-
Returns
-
Promise<NetworkStateProperties[]>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getProperties()
chrome.networking.onc.getProperties(
networkGuid: string,
callback?: function,
)
Ruft alle Eigenschaften des Netzwerks mit der ID networkGuid ab. Enthält alle Attribute des Netzwerks (Lese- und Lese-/Schreibwerte).
Parameter
-
networkGuid
String
Die GUID des Netzwerks, für das Properties abgerufen werden sollen.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: NetworkProperties) => void
-
Ergebnis
-
Returns
-
Promise<NetworkProperties>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
getState()
chrome.networking.onc.getState(
networkGuid: string,
callback?: function,
)
Ruft die im Cache gespeicherten schreibgeschützten Eigenschaften des Netzwerks mit der ID networkGuid ab. Dies soll eine leistungsfähigere Funktion als getProperties
sein, die einen Umlauf erfordert, um das Netzwerksubsystem abzufragen. Die folgenden Eigenschaften werden für alle Netzwerke zurückgegeben: GUID, Type, Name, WiFi.Security. Für sichtbare Netzwerke werden zusätzliche Eigenschaften bereitgestellt: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, für das Properties abgerufen werden sollen.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(result: NetworkStateProperties) => void
-
Ergebnis
-
Returns
-
Promise<NetworkStateProperties>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
requestNetworkScan()
chrome.networking.onc.requestNetworkScan(
networkType?: NetworkType,
)
Fordert das Netzwerksubsystem an, nach neuen Netzwerken zu suchen und die von getVisibleNetworks
zurückgegebene Liste zu aktualisieren. Dies ist nur eine Anfrage. Das Netzwerksubsystem kann sie ignorieren. Wenn die Liste aktualisiert wird, wird das Ereignis onNetworkListChanged
ausgelöst.
Parameter
-
networkType
NetworkType optional
Chrome 63 und höherFalls angegeben, wird ein spezieller Scan für den Typ angefordert. Bei Mobilfunk wird eine Suche nach einem Mobilfunknetz angefordert, sofern dies unterstützt wird.
setProperties()
chrome.networking.onc.setProperties(
networkGuid: string,
properties: NetworkConfigProperties,
callback?: function,
)
Legt die Eigenschaften des Netzwerks mit der ID networkGuid
fest. Dies gilt nur für konfigurierte Netzwerke (Quelle != None). Nicht konfigurierte sichtbare Netzwerke sollten stattdessen createNetwork
verwenden. In Kiosksitzungen schlägt der Aufruf dieser Methode in einem freigegebenen Netzwerk fehl.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, für das Eigenschaften festgelegt werden sollen.
-
Properties
Die festzulegenden Eigenschaften.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
startConnect()
chrome.networking.onc.startConnect(
networkGuid: string,
callback?: function,
)
Stellt eine Verbindung zum Netzwerk mit networkGuid her.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, zu dem eine Verbindung hergestellt werden soll.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
startDisconnect()
chrome.networking.onc.startDisconnect(
networkGuid: string,
callback?: function,
)
Startet eine Netzwerkverbindung mit networkGuid.
Parameter
-
networkGuid
String
Die GUID des Netzwerks, von dem die Verbindung getrennt werden soll.
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Returns
-
Promise<void>
Chrome 125 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
Veranstaltungen
onDeviceStateListChanged
chrome.networking.onc.onDeviceStateListChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich die Liste der Geräte oder die Eigenschaften des Gerätestatus geändert haben.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:() => void
onNetworkListChanged
chrome.networking.onc.onNetworkListChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich die Liste der Netzwerke geändert hat. Sendet eine vollständige Liste der GUIDs für alle aktuellen Netzwerke.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(changes: string[]) => void
-
Änderungen
String[]
-
onNetworksChanged
chrome.networking.onc.onNetworksChanged.addListener(
callback: function,
)
Wird ausgelöst, wenn sich die Eigenschaften in einem der Netzwerke ändern. Sendet eine Liste von GUIDs für Netzwerke, deren Eigenschaften sich geändert haben.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(changes: string[]) => void
-
Änderungen
String[]
-
onPortalDetectionCompleted
chrome.networking.onc.onPortalDetectionCompleted.addListener(
callback: function,
)
Wird ausgelöst, wenn die Portalerkennung für ein Netzwerk abgeschlossen ist. Sendet die GUID des Netzwerks und den entsprechenden Captive Portal-Status.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(networkGuid: string, status: CaptivePortalStatus) => void
-
networkGuid
String
-
status
-