chrome.networking.onc

Opis

Interfejs chrome.networking.onc API służy do konfigurowania połączeń sieciowych (komórkowych, Ethernet, VPN lub Wi-Fi). Ten interfejs API jest dostępny w automatycznie uruchamianych sesjach kiosku ChromeOS.

Konfiguracje połączeń sieciowych są określone zgodnie ze specyfikacją Open Network Configuration (ONC).

UWAGA: większość właściwości słownika i wartości wyliczeniowych używa formatu UpperCamelCase, aby pasować do specyfikacji ONC, a nie konwencji JavaScript lowerCamelCase.

Uprawnienia

networking.onc

Dostępność

Chrome 59 lub nowszy Tylko ChromeOS

Typy

ActivationStateType

Typ wyliczeniowy

„Aktywowano”

„Aktywowanie”

„NotActivated”

„PartiallyActivated”

CaptivePortalStatus

Typ wyliczeniowy

„Nieznany”

„Offline”

„Online”

„Portal”

„ProxyAuthRequired”

CellularProperties

Właściwości

  • ActivationState

    Stan aktywacji konta operatora.

  • ActivationType

    string opcjonalny

    Typ aktywacji sieci komórkowej.

  • AllowRoaming

    wartość logiczna opcjonalna

    Czy roaming jest dozwolony w sieci.

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć komórkowa ma być łączona automatycznie (w zasięgu).

  • Rodzinny

    string opcjonalny

    Rodzina technologii urządzenia komórkowego – CDMA lub GSM.

  • FirmwareRevision

    string opcjonalny

    Wersja oprogramowania układowego w modemie komórkowym.

  • FoundNetworks

    FoundNetworkProperties[] opcjonalnie

    Lista sieci znalezionych podczas ostatniego skanowania.

  • HardwareRevision

    string opcjonalny

    Wersja sprzętowa modemu komórkowego.

  • HomeProvider

    Informacje o operatorze, który wydał kartę SIM zainstalowaną obecnie w modemie.

  • Producent

    string opcjonalny

    Producent modemu komórkowego.

  • ModelID

    string opcjonalny

    Identyfikator modelu modemu komórkowego.

  • NetworkTechnology

    string opcjonalny

    Jeśli modem jest zarejestrowany w sieci, wyświetli się aktualnie używana technologia sieciowa.

  • PaymentPortal

    PaymentPortal opcjonalny

    Portal płatności online, z którego użytkownik może korzystać, aby zarejestrować lub zmodyfikować abonament na mobilną transmisję danych.

  • RoamingState

    string opcjonalny

    Stan roamingu modemu komórkowego w bieżącej sieci.

  • SIMLockStatus

    SIMLockStatus opcjonalny

    Stan blokady karty SIM w przypadku sieci GSM.

  • SIMPresent

    wartość logiczna opcjonalna

    Informacja o tym, czy karta SIM jest włożona.

  • Skanowanie

    wartość logiczna opcjonalna

    Chrome w wersji 63 lub nowszej

    Wartość „true”, gdy trwa skanowanie sieci komórkowej.

  • ServingOperator

    Informacje o operatorze, w którego sieci modem jest obecnie zarejestrowany.

  • SignalStrength

    number opcjonalny

    Aktualna siła sygnału sieci.

  • SupportNetworkScan

    wartość logiczna opcjonalna

    Określa, czy sieć komórkowa obsługuje skanowanie.

CellularProviderProperties

Właściwości

  • Kod

    ciąg znaków

    Identyfikator sieci komórkowej jako proste połączenie kodu MCC (Mobile Country Code) i MNC (Mobile Network Code) sieci.

  • Kraj

    string opcjonalny

    Dwuliterowy kod kraju.

  • Nazwa

    ciąg znaków

    Nazwa operatora.

CellularStateProperties

Właściwości

CertificatePattern

Właściwości

  • EnrollmentURI

    string[] opcjonalne

    Lista identyfikatorów URI, do których użytkownik może zostać przekierowany, jeśli nie zostaną znalezione żadne certyfikaty pasujące do tego wzorca.

  • Wystawca

    Jeśli jest ustawiony, wzorzec, z którym należy dopasować ustawienia wystawcy X.509.

  • IssuerCARef

    string[] opcjonalne

    Lista certyfikatów CA wystawcy certyfikatu. Aby certyfikat pasował do tego wzorca, musi być podpisany przez jeden z tych urzędów.

  • Temat

    Jeśli jest ustawiony, wzorzec, do którego należy dopasować ustawienia podmiotu X.509.

ClientCertificateType

Typ wyliczeniowy

„Ref”

„Pattern”

ConnectionStateType

Typ wyliczeniowy

„Połączono”

„Łączenie”

„NotConnected”

DeviceStateProperties

Właściwości

  • SIMLockStatus

    SIMLockStatus opcjonalny

    Chrome 62 lub nowsza

    Stan blokady karty SIM, jeśli Type = Cellular i SIMPresent = True.

  • SIMPresent

    wartość logiczna opcjonalna

    Chrome 62 lub nowsza

    Ustaw stan obecności karty SIM, jeśli typ urządzenia to komórkowy.

  • Skanowanie

    wartość logiczna opcjonalna

    Określa, czy urządzenie jest włączone. Wartość Prawda, jeśli urządzenie jest obecnie skanowane.

  • Bieżący stan urządzenia.

  • Rodzaj sieci powiązany z urządzeniem (komórkowa, Ethernet lub Wi-Fi).

DeviceStateType

Typ wyliczeniowy

„Nie zainicjowano”
Urządzenie jest dostępne, ale nie zostało zainicjowane.

„Wyłączone”
Urządzenie jest zainicjowane, ale nie włączone.

„Włączanie”
Stan włączony został zgłoszony, ale nie został jeszcze osiągnięty.

„Włączone”
Urządzenie jest włączone.

„Zabronione”
Urządzenie jest zabronione.

EAPProperties

Właściwości

  • AnonymousIdentity

    string opcjonalny

  • ClientCertPKCS11Id

    string opcjonalny

    Chrome 60 lub nowsza
  • ClientCertPattern

    CertificatePattern opcjonalny

  • ClientCertProvisioningProfileId

    string opcjonalny

    Chrome 93 lub nowszy
  • ClientCertRef

    string opcjonalny

  • ClientCertType
  • Tożsamość

    string opcjonalny

  • Inner

    string opcjonalny

  • Outer

    string opcjonalny

    Zewnętrzny typ EAP. Wymagane przez ONC, ale może nie być dostępne podczas tłumaczenia z języka Shill.

  • Hasło

    string opcjonalny

  • SaveCredentials

    wartość logiczna opcjonalna

  • ServerCAPEMs

    string[] opcjonalne

  • ServerCARefs

    string[] opcjonalne

  • SubjectMatch

    ManagedDOMString opcjonalny

    Chrome 60 lub nowsza
  • UseProactiveKeyCaching

    wartość logiczna opcjonalna

  • UseSystemCAs

    wartość logiczna opcjonalna

EthernetProperties

Właściwości

  • Uwierzytelnianie

    string opcjonalny

    Uwierzytelnianie używane przez sieć Ethernet. Możliwe wartości to None8021X.

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć Ethernet ma być połączona automatycznie.

  • EAP

    EAPProperties opcjonalny

    Ustawienia EAP sieci. Wymagany do uwierzytelniania 8021X.

EthernetStateProperties

Właściwości

FoundNetworkProperties

Właściwości

  • LongName

    string opcjonalny

    Długa nazwa operatora sieci.

  • NetworkId

    ciąg znaków

    Identyfikator sieci.

  • ShortName

    string opcjonalny

    Krótka nazwa operatora sieci.

  • Stan

    ciąg znaków

    Dostępność sieci.

  • Technologia

    ciąg znaków

    Technologia dostępu używana przez sieć.

GlobalPolicy

Właściwości

  • AllowOnlyPolicyNetworksToAutoconnect

    wartość logiczna opcjonalna

    Jeśli ta zasada ma wartość Prawda, automatycznie mogą łączyć się tylko sieci objęte zasadami. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnect

    wartość logiczna opcjonalna

    Jeśli ma wartość prawda, można łączyć się tylko z sieciami zgodnymi z zasadami. Nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    wartość logiczna opcjonalna

    Chrome w wersji 70 lub nowszej

    Jeśli ta zasada ma wartość Prawda, a na liście widocznych sieci jest dostępna sieć zarządzana, można łączyć się tylko z sieciami objętymi zasadami. Nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • BlockedHexSSIDs

    string[] opcjonalne

    Chrome w wersji 86 lub nowszej

    Lista zablokowanych sieci. Połączenia z zablokowanymi sieciami są niedozwolone. Sieci można ponownie odblokować, określając jawną konfigurację sieci. Domyślnie jest to pusta lista.

IPConfigProperties

Właściwości

  • ExcludedRoutes

    string[] opcjonalne

    Chrome w wersji 76 lub nowszej

    Tablica bloków adresów IP w notacji CIDR. Więcej informacji znajdziesz w pliku onc_spec.md.

  • Brama

    string opcjonalny

    Adres bramy używany w konfiguracji IP.

  • IPAddress

    string opcjonalny

    Adres IP połączenia. Może to być adres IPv4 lub IPv6, w zależności od wartości parametru Type.

  • IncludedRoutes

    string[] opcjonalne

    Chrome w wersji 76 lub nowszej

    Tablica bloków adresów IP w notacji CIDR. Więcej informacji znajdziesz w pliku onc_spec.md.

  • NameServers

    string[] opcjonalne

    Tablica adresów używanych na potrzeby serwerów nazw.

  • RoutingPrefix

    number opcjonalny

    Prefiks routingu.

  • SearchDomains

    string[] opcjonalne

    Chrome w wersji 76 lub nowszej

    Tablica ciągów znaków do rozpoznawania nazw. Szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • Typ

    string opcjonalny

    Typ konfiguracji IP. Może mieć wartość IPv4 lub IPv6.

  • WebProxyAutoDiscoveryUrl

    string opcjonalny

    Adres URL protokołu Web Proxy Auto-Discovery zgłoszony przez DHCP.

IPConfigType

Typ wyliczeniowy

„DHCP”

„Static”

IssuerSubjectPattern

Właściwości

  • CommonName

    string opcjonalny

    Jeśli jest ustawiona, wartość, z którą ma być porównywana wspólna nazwa podmiotu certyfikatu.

  • Miejscowość

    string opcjonalny

    Jeśli jest ustawiona, wartość, z którą ma być porównywana wspólna lokalizacja podmiotu certyfikatu.

  • Organizacja

    string opcjonalny

    Jeśli jest ustawiona, wartość, z którą mają być porównywane organizacje podmiotu certyfikatu. Co najmniej 1 organizacja powinna odpowiadać wartości.

  • OrganizationalUnit

    string opcjonalny

    Jeśli ta opcja jest ustawiona, jest to wartość, z którą mają być zgodne jednostki organizacyjne podmiotu certyfikatu. Co najmniej 1 jednostka organizacyjna powinna odpowiadać wartości.

ManagedBoolean

Właściwości

  • Aktywne

    wartość logiczna opcjonalna

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    wartość logiczna opcjonalna

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    wartość logiczna opcjonalna

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    wartość logiczna opcjonalna

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    wartość logiczna opcjonalna

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedCellularProperties

Właściwości

ManagedDOMString

Właściwości

  • Aktywne

    string opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    string opcjonalny

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    string opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    string opcjonalny

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    string opcjonalny

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedDOMStringList

Właściwości

  • Aktywne

    string[] opcjonalne

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    string[] opcjonalne

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    string[] opcjonalne

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    string[] opcjonalne

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    string[] opcjonalne

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedEthernetProperties

Właściwości

ManagedIPConfigProperties

Właściwości

ManagedIPConfigType

Właściwości

  • Aktywne

    IPConfigType opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    IPConfigType opcjonalny

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    IPConfigType opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    IPConfigType opcjonalny

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    IPConfigType opcjonalny

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedLong

Właściwości

  • Aktywne

    number opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    number opcjonalny

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    number opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    number opcjonalny

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    number opcjonalny

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedManualProxySettings

Właściwości

ManagedProperties

Właściwości

ManagedProxyLocation

Właściwości

ManagedProxySettings

Właściwości

ManagedProxySettingsType

Właściwości

  • Aktywne

    ProxySettingsType opcjonalny

    Aktywna wartość używana obecnie przez menedżera konfiguracji sieci (np. Shill).

  • DeviceEditable

    wartość logiczna opcjonalna

    Czy dla usługi istnieje zasada dotycząca urządzeń, która umożliwia edytowanie usługi (czyli zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    ProxySettingsType opcjonalny

    Wartość właściwości podana przez zasadę urządzenia.

  • Realizowana

    string opcjonalny

    Źródło, z którego pochodzi rzeczywista wartość usługi.

  • SharedSetting

    ProxySettingsType opcjonalny

    Wartość ustawiona dla wszystkich użytkowników urządzenia. Podawany tylko wtedy, gdy wartość atrybutu DeviceEditiable to true.

  • UserEditable

    wartość logiczna opcjonalna

    Czy w przypadku usługi istnieje zasada UserPolicy, która umożliwia jej edytowanie (czyli ustawienie zalecanej wartości właściwości). Domyślna wartość to false.

  • UserPolicy

    ProxySettingsType opcjonalny

    Wartość usługi podana w zasadach użytkownika.

  • UserSetting

    ProxySettingsType opcjonalny

    Wartość usługi ustawiona przez zalogowanego użytkownika. Podawany tylko wtedy, gdy wartość atrybutu UserEditable to true.

ManagedThirdPartyVPNProperties

Właściwości

ManagedVPNProperties

Właściwości

ManagedWiFiProperties

Właściwości

ManualProxySettings

Właściwości

  • FTPProxy

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy FTP.

  • HTTPProxy

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy HTTP.

  • SOCKS

    ProxyLocation opcjonalnie

    Ustawienia serwera proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation opcjonalnie

    Ustawienia bezpiecznego serwera proxy HTTP.

NetworkConfigProperties

Właściwości

NetworkFilter

Właściwości

  • skonfigurowano

    wartość logiczna opcjonalna

    Jeśli ma wartość Prawda, uwzględnia tylko skonfigurowane (zapisane) sieci. Domyślna wartość to „false”.

  • limit

    number opcjonalny

    Maksymalna liczba sieci do zwrócenia. Jeśli nie zostanie podana, domyślnie przyjmuje wartość 1000. Aby nie stosować limitu, użyj wartości 0.

  • networkType

    Typ sieci do zwrócenia.

  • widoczna

    wartość logiczna opcjonalna

    Jeśli wartość to „true”, uwzględniaj tylko widoczne sieci (połączone fizycznie lub w zasięgu). Domyślna wartość to „false”.

NetworkProperties

Właściwości

  • Sieć komórkowa

    CellularProperties opcjonalny

    W przypadku sieci komórkowych – właściwości sieci komórkowej.

  • Możliwość połączenia

    wartość logiczna opcjonalna

    czy można połączyć się z siecią;

  • ConnectionState

    Bieżący stan połączenia sieci.

  • ErrorState

    string opcjonalny

    Ostatni zarejestrowany stan błędu sieci.

  • Ethernet

    EthernetProperties opcjonalny

    W przypadku sieci Ethernet są to właściwości sieci Ethernet.

  • GUID

    ciąg znaków

    Identyfikator GUID sieci.

  • IPAddressConfigType

    IPConfigType opcjonalny

    Typ konfiguracji adresów IP sieci.

  • IPConfigs

    IPConfigProperties[] opcjonalny

    Konfiguracja IP sieci.

  • MacAddress

    string opcjonalny

    Adres MAC sieci.

  • Użycie danych jest mierzone

    wartość logiczna opcjonalna

    Chrome w wersji 85 lub nowszej

    Określa, czy sieć ma pomiar użycia danych.

  • Nazwa

    string opcjonalny

    Przyjazna dla użytkownika nazwa sieci.

  • NameServersConfigType

    IPConfigType opcjonalny

    Typ konfiguracji IP serwerów nazw używanych przez sieć.

  • Priorytet

    number opcjonalny

    Priorytet sieci.

  • ProxySettings

    ProxySettings opcjonalne

    Ustawienia serwera proxy sieci.

  • RestrictedConnectivity

    wartość logiczna opcjonalna

    W przypadku połączonej sieci informuje, czy połączenie sieciowe z internetem jest ograniczone, np. jeśli sieć znajduje się za portalem lub sieć komórkowa nie jest aktywowana.

  • SavedIPConfig

    IPConfigProperties opcjonalne

    Konfiguracja IP otrzymana z serwera DHCP przed zastosowaniem konfiguracji statycznego adresu IP.

  • Źródło

    string opcjonalny

    Wskazuje, czy i jak sieć jest skonfigurowana. Możliwe wartości to:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    Wartość „None” powoduje konflikt z generowaniem kodu rozszerzenia, dlatego zamiast wyliczenia SourceType musimy użyć ciągu znaków dla wartości „Source”.

  • StaticIPConfig

    IPConfigProperties opcjonalne

    Konfiguracja statycznego adresu IP sieci.

  • TrafficCounterResetTime

    number opcjonalny

    Chrome 125 lub nowsza

    Kiedy liczniki natężenia ruchu zostały ostatnio zresetowane.

  • Typ sieci.

  • VPN

    VPNProperties opcjonalnie

    W przypadku sieci VPN są to właściwości sieci VPN.

  • Wi-Fi

    WiFiProperties opcjonalnie

    W przypadku sieci Wi-Fi są to właściwości sieci Wi-Fi.

NetworkStateProperties

Właściwości

NetworkType

Typ wyliczeniowy

„Wszystkie”

„Komórkowa”

„Ethernet”

„Tether”

„VPN”

„Bezprzewodowe”

„Wi-Fi”

PaymentPortal

Właściwości

  • Metoda

    ciąg znaków

    Metoda HTTP, która ma być używana w przypadku portalu płatności.

  • PostData

    string opcjonalny

    Dane POST do wysłania do portalu płatności. Ignorowane, chyba że Method ma wartość POST.

  • URL

    string opcjonalny

    Adres URL portalu płatności.

ProxyLocation

Właściwości

  • Host

    ciąg znaków

    Host adresu IP serwera proxy.

  • Port

    liczba

    Port używany przez serwer proxy.

ProxySettings

Właściwości

  • ExcludeDomains

    string[] opcjonalne

    Domeny i hosty, dla których wykluczone są ręczne ustawienia proxy.

  • Ręcznie

    Ręczne ustawienia serwera proxy – używane tylko w przypadku ustawień serwera proxy Manual.

  • PAC

    string opcjonalny

    Adres URL pliku automatycznej konfiguracji serwera proxy.

  • Typ ustawień serwera proxy.

ProxySettingsType

Typ wyliczeniowy

„Direct”

„Manual”

„PAC”

„WPAD”

SIMLockStatus

Właściwości

  • LockEnabled

    Wartość logiczna

    Określa, czy blokada SIM jest włączona.

  • LockType

    ciąg znaków

    Stan blokady SIM – możliwe wartości to 'sim-pin', 'sim-puk'''.

  • RetriesLeft

    number opcjonalny

    Liczba prób odblokowania karty SIM za pomocą kodu PIN, po których wymagane jest użycie kodu PUK.

ThirdPartyVPNProperties

Właściwości

  • ExtensionID

    ciąg znaków

    Identyfikator rozszerzenia zewnętrznego dostawcy VPN.

  • ProviderName

    string opcjonalny

    Nazwa dostawcy VPN.

VPNProperties

Właściwości

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć VPN ma być połączona automatycznie.

  • Host

    string opcjonalny

    Host sieci VPN.

  • Typ

    string opcjonalny

    Typ sieci VPN. Nie może to być wyliczenie z powodu „L2TP-IPSec”. Jest to opcjonalne w przypadku NetworkConfigProperties, które jest przekazywane do setProperties, co może służyć do ustawiania tylko określonych właściwości.

VPNStateProperties

Właściwości

WiFiProperties

Właściwości

  • AllowGatewayARPPolling

    wartość logiczna opcjonalna

    Wycofane w Chrome 131

    Usunięto w wersji M131. Obecnie nie ma aktywnego sondowania ARP.

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć Wi-Fi ma być łączona automatycznie, gdy jest w zasięgu.

  • BSSID

    string opcjonalny

    Identyfikator BSSID powiązanego punktu dostępu.

  • EAP

    EAPProperties opcjonalny

    Właściwości sieci EAP. Wymagane w przypadku sieci WEP-8021XWPA-EAP.

  • Częstotliwość

    number opcjonalny

    Częstotliwość działania usługi Wi-Fi w MHz. W przypadku połączonych sieci jest to bieżąca częstotliwość, z którą połączona jest sieć. W przeciwnym razie częstotliwość najlepszego dostępnego BSS.

  • FrequencyList

    number[] opcjonalny

    Zawiera wszystkie częstotliwości operacyjne, które były ostatnio używane w sieci Wi-Fi.

  • HexSSID

    string opcjonalny

    Skopiowany identyfikator SSID sieci zakodowany w systemie szesnastkowym.

  • HiddenSSID

    wartość logiczna opcjonalna

    Określa, czy identyfikator SSID sieci będzie rozpowszechniany.

  • Hasło wielowyrazowe

    string opcjonalny

    Chrome 66 lub nowsza

    Hasło do połączeń WEP/WPA/WPA2. Tę właściwość można tylko ustawić – właściwości zwracane przez getProperties nie będą zawierać tej wartości.

  • RoamThreshold

    number opcjonalny

    Wycofane, zignorowane.

  • SSID

    string opcjonalny

    Identyfikator SSID sieci.

  • Bezpieczeństwo

    string opcjonalny

    Typ zabezpieczeń sieci.

  • SignalStrength

    number opcjonalny

    siła sygnału sieci;

WiFiStateProperties

Właściwości

WiMAXProperties

Właściwości

  • AutoConnect

    wartość logiczna opcjonalna

    Określa, czy sieć ma być łączona automatycznie.

  • EAP

    EAPProperties opcjonalny

    Właściwości sieci EAP.

Metody

createNetwork()

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

Tworzy nową konfigurację sieci na podstawie właściwości. Jeśli skonfigurowana sieć o takich samych parametrach już istnieje, operacja się nie powiedzie. W przeciwnym razie zwraca identyfikator GUID nowej sieci.

Parametry

  • udostępnioną

    Wartość logiczna

    Jeśli true, udostępnij tę konfigurację sieci innym użytkownikom.

    Ta opcja jest dostępna tylko w interfejsie internetowym Chrome.* W przypadku wywoływania przez aplikacje jedyną dozwoloną wartością jest false.

  • Właściwości, za pomocą których skonfigurujesz nową sieć.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: string) => void

    • wynik

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

disableNetworkType()

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

Wyłącza wszystkie urządzenia pasujące do określonego typu sieci. Zobacz notatkę dotyczącą enableNetworkType.

Parametry

enableNetworkType()

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

Umożliwia korzystanie z dowolnych urządzeń pasujących do określonego typu sieci. Pamiętaj, że typ może reprezentować wiele typów sieci (np. „Bezprzewodowa”).

Parametry

forgetNetwork()

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

Zapomina konfigurację sieci, usuwając wszystkie skonfigurowane właściwości sieci o identyfikatorze GUID networkGuid. Może to obejmować również inne sieci o pasujących identyfikatorach (np. identyfikator SSID sieci Wi-Fi i zabezpieczenia). Jeśli taka konfiguracja nie istnieje, zostanie ustawiony błąd, a operacja zakończy się niepowodzeniem.

W sesjach kiosku ta metoda nie będzie mogła zapomnieć konfiguracji sieci udostępnionej.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, którą chcesz zapomnieć.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getCaptivePortalStatus()

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

Zwraca stan portalu przechwytującego w przypadku sieci pasującej do parametru „networkGuid”.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz uzyskać stan portalu przechwytującego.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: CaptivePortalStatus) => void

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getDeviceStates()

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

Zwraca stany dostępnych urządzeń sieciowych.

Parametry

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getGlobalPolicy()

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

Pobiera właściwości zasad globalnych. Właściwości te nie powinny się zmieniać w trakcie sesji.

Parametry

Zwroty

  • Promise<GlobalPolicy>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getManagedProperties()

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

Pobiera scalone właściwości sieci o identyfikatorze networkGuid z tych źródeł: ustawienia użytkownika, ustawienia udostępnione, zasady użytkownika, zasady dotyczące urządzenia i obecnie aktywne ustawienia.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz uzyskać właściwości.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: ManagedProperties) => void

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getNetworks()

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

Zwraca listę obiektów sieci o tych samych właściwościach, które są podane przez getState. Filtr służy do określania typu zwracanych sieci i ograniczania ich liczby. Sieci są uporządkowane przez system według priorytetu, przy czym na początku listy znajdują się sieci połączone lub w trakcie łączenia.

Parametry

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getProperties()

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

Pobiera wszystkie właściwości sieci o identyfikatorze networkGuid. Obejmuje wszystkie właściwości sieci (wartości tylko do odczytu i do odczytu/zapisu).

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz uzyskać właściwości.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: NetworkProperties) => void

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getState()

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

Pobiera zapisane w pamięci podręcznej właściwości sieci o identyfikatorze networkGuid, które są dostępne tylko do odczytu. Ta funkcja ma być wydajniejsza niż getProperties, która wymaga wykonania pełnego cyklu zapytania do podsystemu sieciowego. W przypadku wszystkich sieci zwracane są te właściwości: GUID, Type, Name, WiFi.Security. W przypadku widocznych sieci podawane są dodatkowe właściwości: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz uzyskać właściwości.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: NetworkStateProperties) => void

Zwroty

  • Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

requestNetworkScan()

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

Żąda, aby podsystem sieciowy wyszukał nowe sieci i zaktualizował listę zwracaną przez getVisibleNetworks. To tylko prośba: podsystem sieciowy może ją zignorować. Jeśli lista zostanie zaktualizowana, zostanie wywołane zdarzenie onNetworkListChanged.

Parametry

  • networkType

    NetworkType opcjonalny

    Chrome w wersji 63 lub nowszej

    Jeśli podano, żąda skanowania konkretnego typu. W przypadku sieci komórkowej, jeśli jest to obsługiwane, zostanie wysłane żądanie skanowania sieci komórkowej.

setProperties()

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

Ustawia właściwości sieci o identyfikatorze networkGuid. Dotyczy to tylko skonfigurowanych sieci (Źródło != Brak). Nieskonfigurowane widoczne sieci powinny używać znacznika createNetwork. W sesjach kiosku wywołanie tej metody w sieci udostępnionej zakończy się niepowodzeniem.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, dla której chcesz ustawić właściwości.

  • Właściwości do ustawienia.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

startConnect()

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

Rozpoczyna połączenie z siecią o identyfikatorze networkGuid.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, z którą chcesz się połączyć.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

startDisconnect()

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

Rozpoczyna odłączanie od sieci o identyfikatorze networkGuid.

Parametry

  • networkGuid

    ciąg znaków

    Identyfikator GUID sieci, od której chcesz się odłączyć.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 125 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onDeviceStateListChanged

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

Wywoływane, gdy zmieni się lista urządzeń lub właściwości stanu urządzenia.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    () => void

onNetworkListChanged

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

Wysyłane, gdy zmieni się lista sieci. Wysyła pełną listę identyfikatorów GUID wszystkich bieżących sieci.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (changes: string[]) => void

    • Zmiany

      string[]

onNetworksChanged

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

Wyzwalane, gdy właściwości ulegną zmianie w dowolnej sieci. Wysyła listę identyfikatorów GUID sieci, których usługi uległy zmianie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (changes: string[]) => void

    • Zmiany

      string[]

onPortalDetectionCompleted

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

Uruchamiane po zakończeniu wykrywania portalu w sieci. Wysyła identyfikator GUID sieci i odpowiedni stan portalu przechwytującego.

Parametry