chrome.networking.onc

Opis

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

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

NOTE większość właściwości słownika i wartości wyliczeniowych używa zapisu UpperCamelCase, aby zachować zgodność ze specyfikacją ONC, zamiast konwencji lowerCamelCase języka JavaScript.

Uprawnienia

networking.onc

Dostępność

Chrome 59 lub nowsza wersja 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

    ciąg znaków opcjonalny

    Typ aktywacji sieci komórkowej.

  • AllowRoaming

    boolean opcjonalne

    Czy roaming jest dozwolony w sieci.

  • AutoConnect

    boolean opcjonalne

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

  • Dla całej rodziny

    ciąg znaków opcjonalny

    Rodzina technologii urządzeń komórkowych – CDMA lub GSM.

  • FirmwareRevision

    ciąg znaków opcjonalny

    Wersja oprogramowania układowego wczytana w modemie komórkowym.

  • FoundNetworks

    Lista sieci znalezionych podczas ostatniego skanowania sieci.

  • HardwareRevision

    ciąg znaków opcjonalny

    Wersja sprzętu modemu komórkowego.

  • HomeProvider

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

  • Producent

    ciąg znaków opcjonalny

    Producent modemu komórkowego.

  • ModelID

    ciąg znaków opcjonalny

    Identyfikator modelu modemu komórkowego.

  • NetworkTechnology

    ciąg znaków opcjonalny

    Jeśli modem jest zarejestrowany w sieci, technologia sieciowa, która jest obecnie używana.

  • PaymentPortal

    PaymentPortal opcjonalny

    Portal płatności online, za pomocą którego użytkownik może zarejestrować się w pakiecie danych mobilnych lub go zmienić.

  • RoamingState

    ciąg znaków opcjonalny

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

  • SIMLockStatus

    SIMLockStatus opcjonalny

    Stan blokady karty SIM w sieciach GSM.

  • SIMPresent

    boolean opcjonalne

    czy karta SIM jest obecna;

  • Skanowanie

    boolean opcjonalne

    Chrome 63 lub nowsza wersja

    Wartość True, gdy trwa skanowanie sieci komórkowej.

  • ServingOperator

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

  • SignalStrength

    number optional

    Bieżąca siła sygnału sieci.

  • SupportNetworkScan

    boolean opcjonalne

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

CellularProviderProperties

Właściwości

  • Kod

    tekst

    Identyfikator sieci komórkowej jako prosta konkatenacja kodów MCC (Mobile Country Code) i MNC (Mobile Network Code).

  • Kraj

    ciąg znaków opcjonalny

    Dwuliterowy kod kraju.

  • Nazwa

    tekst

    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, do którego powinny być dopasowane 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 nich.

  • Temat

    Jeśli jest ustawiony, wzorzec, do którego powinny być dopasowane ustawienia podmiotu X.509.

ClientCertificateType

Typ wyliczeniowy

"Ref"

„Wzór”

ConnectionStateType

Typ wyliczeniowy

„Połączono”

„Łączę”

"NotConnected"

DeviceStateProperties

Właściwości

  • SIMLockStatus

    SIMLockStatus opcjonalny

    Chrome 62 lub nowsza wersja

    Stan blokady karty SIM, jeśli Typ = Sieć komórkowa, a Karta SIM obecna = Prawda.

  • SIMPresent

    boolean opcjonalne

    Chrome 62 lub nowsza wersja

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

  • Skanowanie

    boolean opcjonalne

    Określ, czy urządzenie jest włączone. Prawda, jeśli urządzenie aktualnie skanuje.

  • Bieżący stan urządzenia.

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

DeviceStateType

Typ wyliczeniowy

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

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

„Włączanie”
Zażądano włączenia, ale proces nie został jeszcze zakończony.

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

"Prohibited"
Urządzenie jest niedozwolone.

EAPProperties

Właściwości

  • AnonymousIdentity

    ciąg znaków opcjonalny

  • ClientCertPKCS11Id

    ciąg znaków opcjonalny

    Chrome 60 lub nowsza wersja
  • ClientCertPattern

    CertificatePattern opcjonalne

  • ClientCertProvisioningProfileId

    ciąg znaków opcjonalny

    Chrome 93 lub nowsza wersja
  • ClientCertRef

    ciąg znaków opcjonalny

  • ClientCertType
  • Tożsamość

    ciąg znaków opcjonalny

  • Inner

    ciąg znaków opcjonalny

  • Outer

    ciąg znaków opcjonalny

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

  • Hasło

    ciąg znaków opcjonalny

  • SaveCredentials

    boolean opcjonalne

  • ServerCAPEMs

    string[] opcjonalne

  • ServerCARefs

    string[] opcjonalne

  • SubjectMatch

    ManagedDOMString opcjonalnie

    Chrome 60 lub nowsza wersja
  • UseProactiveKeyCaching

    boolean opcjonalne

  • UseSystemCAs

    boolean opcjonalne

EthernetProperties

Właściwości

  • Uwierzytelnianie

    ciąg znaków opcjonalny

    Uwierzytelnianie używane przez sieć Ethernet. Możliwe wartości to None i 8021X.

  • AutoConnect

    boolean opcjonalne

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

  • EAP

    EAPProperties opcjonalne

    Ustawienia EAP sieci. Wymagane do uwierzytelniania 8021X.

EthernetStateProperties

Właściwości

FoundNetworkProperties

Właściwości

  • LongName

    ciąg znaków opcjonalny

    Nazwa operatora sieci w długim formacie.

  • NetworkId

    tekst

    Identyfikator sieci.

  • ShortName

    ciąg znaków opcjonalny

    Krótka nazwa operatora sieci.

  • Stan

    tekst

    Dostępność sieci.

  • Technologia

    tekst

    Technologia dostępu używana przez sieć.

GlobalPolicy

Właściwości

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean opcjonalne

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

  • AllowOnlyPolicyNetworksToConnect

    boolean opcjonalne

    Jeśli zasada ma wartość Prawda, można łączyć się tylko z sieciami zasad i nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean opcjonalne

    Chrome 70 lub nowsza wersja

    Jeśli 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 i nie można dodawać ani konfigurować nowych sieci. Wartość domyślna to fałsz.

  • BlockedHexSSIDs

    string[] opcjonalne

    Chrome 86 lub nowsza wersja

    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 76 lub nowsza wersja

    Tablica bloków adresów IP w notacji CIDR. Szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • Brama

    ciąg znaków opcjonalny

    Adres bramy używany w konfiguracji IP.

  • IPAddress

    ciąg znaków opcjonalny

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

  • IncludedRoutes

    string[] opcjonalne

    Chrome 76 lub nowsza wersja

    Tablica bloków adresów IP w notacji CIDR. Szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • NameServers

    string[] opcjonalne

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

  • RoutingPrefix

    number optional

    Prefiks routingu.

  • SearchDomains

    string[] opcjonalne

    Chrome 76 lub nowsza wersja

    Tablica ciągów znaków do tłumaczenia nazwy (domeny). Szczegółowe informacje znajdziesz w pliku onc_spec.md.

  • Typ

    ciąg znaków opcjonalny

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

  • WebProxyAutoDiscoveryUrl

    ciąg znaków opcjonalny

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

IPConfigType

Typ wyliczeniowy

"DHCP"

"Static"

IssuerSubjectPattern

Właściwości

  • CommonName

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, do której ma być dopasowana nazwa domeny w certyfikacie (wspólna nazwa).

  • Miejscowość

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, do której ma być dopasowana wspólna lokalizacja podmiotu certyfikatu.

  • Organizacja

    ciąg znaków opcjonalny

    Jeśli jest ustawiona, wartość, z którą ma być dopasowywana organizacja podmiotu certyfikatu. Co najmniej 1 organizacja powinna pasować do wartości.

  • OrganizationalUnit

    ciąg znaków opcjonalny

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

ManagedBoolean

Właściwości

  • Aktywne

    boolean opcjonalne

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

  • DeviceEditable

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    boolean opcjonalne

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    boolean opcjonalne

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    boolean opcjonalne

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    boolean opcjonalne

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable to true.

ManagedCellularProperties

Właściwości

ManagedDOMString

Właściwości

  • Aktywne

    ciąg znaków opcjonalny

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

  • DeviceEditable

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    ciąg znaków opcjonalny

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    ciąg znaków opcjonalny

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ciąg znaków opcjonalny

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    ciąg znaków opcjonalny

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable to true.

ManagedDOMStringList

Właściwości

  • Aktywne

    string[] opcjonalne

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

  • DeviceEditable

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    string[] opcjonalne

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    string[] opcjonalne

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    string[] opcjonalne

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    string[] opcjonalne

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable to true.

ManagedEthernetProperties

Właściwości

ManagedIPConfigProperties

Właściwości

ManagedIPConfigType

Właściwości

  • Aktywne

    IPConfigType opcjonalne

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

  • DeviceEditable

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    IPConfigType opcjonalne

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    IPConfigType opcjonalne

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    IPConfigType opcjonalne

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    IPConfigType opcjonalne

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy UserEditable to true.

ManagedLong

Właściwości

  • Aktywne

    number optional

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

  • DeviceEditable

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    number optional

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    number optional

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    number optional

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    number optional

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy 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

    boolean opcjonalne

    Czy istnieje zasada DevicePolicy dla danej właściwości i czy umożliwia ona jej edytowanie (tj. czy zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • DevicePolicy

    ProxySettingsType opcjonalny

    Wartość właściwości podana przez zasady dotyczące urządzeń.

  • Realizowana

    ciąg znaków opcjonalny

    Źródło, na podstawie którego określono wartość właściwości.

  • SharedSetting

    ProxySettingsType opcjonalny

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

  • UserEditable

    boolean opcjonalne

    Czy istnieje zasada UserPolicy dotycząca właściwości i czy umożliwia ona edytowanie właściwości (np. zasada ustawia zalecaną wartość właściwości). Domyślna wartość to false.

  • UserPolicy

    ProxySettingsType opcjonalny

    Wartość właściwości podana w zasadach dotyczących użytkowników.

  • UserSetting

    ProxySettingsType opcjonalny

    Wartość właściwości ustawiona przez zalogowanego użytkownika. Podawane tylko wtedy, gdy 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 opcjonalne

    Ustawienia serwera proxy FTP.

  • HTTPProxy

    ProxyLocation opcjonalne

    Ustawienia serwera proxy HTTP.

  • SOCKS

    ProxyLocation opcjonalne

    Ustawienia serwera proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation opcjonalne

    Ustawienia bezpiecznego serwera proxy HTTP.

NetworkConfigProperties

Właściwości

NetworkFilter

Właściwości

  • skonfigurowano

    boolean opcjonalne

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

  • limit

    number optional

    Maksymalna liczba sieci do zwrócenia. Jeśli nie zostanie określona, domyślna wartość to 1000. Wpisz 0, aby nie ustawiać limitu.

  • networkType

    Typ sieci do zwrócenia.

  • widoczna

    boolean opcjonalne

    Jeśli ma wartość „true”, uwzględnia tylko widoczne sieci (połączone fizycznie lub w zasięgu). Wartość domyślna 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

    boolean opcjonalne

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

  • ConnectionState

    Bieżący stan połączenia sieci.

  • ErrorState

    ciąg znaków opcjonalny

    Ostatni zarejestrowany stan błędu sieci.

  • Ethernet

    EthernetProperties opcjonalne

    W przypadku sieci Ethernet – właściwości sieci Ethernet.

  • GUID

    tekst

    Identyfikator GUID sieci.

  • IPAddressConfigType

    IPConfigType opcjonalne

    Typ konfiguracji adresu IP sieci.

  • IPConfigs

    IPConfigProperties[] opcjonalny

    Konfiguracja IP sieci.

  • MacAddress

    ciąg znaków opcjonalny

    Adres MAC sieci.

  • Użycie danych jest mierzone

    boolean opcjonalne

    Chrome 85 lub nowsza wersja

    Czy sieć jest mierzona.

  • Nazwa

    ciąg znaków opcjonalny

    Przyjazna dla użytkownika nazwa sieci.

  • NameServersConfigType

    IPConfigType opcjonalne

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

  • Priorytet

    number optional

    Priorytet sieci.

  • ProxySettings

    ProxySettings opcjonalne

    Ustawienia serwera proxy sieci.

  • RestrictedConnectivity

    boolean opcjonalne

    W przypadku połączonej sieci – czy połączenie sieciowe z internetem jest ograniczone, np. jeśli sieć jest 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

    ciąg znaków 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 w przypadku pola „Source” musimy użyć ciągu znaków zamiast typu wyliczeniowego SourceType.

  • StaticIPConfig

    IPConfigProperties opcjonalne

    Konfiguracja statycznego adresu IP sieci.

  • TrafficCounterResetTime

    number optional

    Chrome 125 lub nowsza wersja

    Kiedy liczniki ruchu zostały ostatnio zresetowane.

  • Typ sieci.

  • VPN

    VPNProperties opcjonalne

    W przypadku sieci VPN – właściwości sieci VPN.

  • Wi-Fi

    WiFiProperties opcjonalne

    W przypadku sieci Wi-Fi – właściwości sieci Wi-Fi.

NetworkStateProperties

Właściwości

NetworkType

Typ wyliczeniowy

„Wszystkie”

„Sieć komórkowa”

„Ethernet”

„Tether”

„VPN”

„Sieć bezprzewodowa”

„Wi-Fi”

PaymentPortal

Właściwości

  • Metoda

    tekst

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

  • PostData

    ciąg znaków opcjonalny

    Dane posta, które mają zostać wysłane do portalu płatności. Ignorowana, chyba że zasada Method ma wartość POST.

  • URL

    ciąg znaków opcjonalny

    Adres URL portalu płatności.

ProxyLocation

Właściwości

  • Host

    tekst

    Host adresu IP serwera proxy.

  • Port

    liczba

    Port, który ma być używany przez serwer proxy.

ProxySettings

Właściwości

  • ExcludeDomains

    string[] opcjonalne

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

  • Ręcznie

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

  • PAC

    ciąg znaków opcjonalny

    Adres URL pliku automatycznej konfiguracji serwera proxy.

  • Typ ustawień serwera proxy.

ProxySettingsType

Typ wyliczeniowy

"Direct"

„Ręcznie”

„PAC”

"WPAD"

SIMLockStatus

Właściwości

  • LockEnabled

    wartość logiczna

    Czy blokada karty SIM jest włączona.

  • LockType

    tekst

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

  • RetriesLeft

    number optional

    Liczba prób odblokowania kodem PIN, po których do odblokowania karty SIM wymagany jest kod PUK.

ThirdPartyVPNProperties

Właściwości

  • ExtensionID

    tekst

    Identyfikator rozszerzenia zewnętrznego dostawcy sieci VPN.

  • ProviderName

    ciąg znaków opcjonalny

    Nazwa dostawcy sieci VPN.

VPNProperties

Właściwości

  • AutoConnect

    boolean opcjonalne

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

  • Host

    ciąg znaków opcjonalny

    Host VPN.

  • Typ

    ciąg znaków opcjonalny

    Typ sieci VPN. Nie może to być typ wyliczeniowy ze względu na „L2TP-IPSec”. Jest to opcjonalne w przypadku NetworkConfigProperties, które jest przekazywane do setProperties i może być używane do ustawiania tylko określonych właściwości.

VPNStateProperties

Właściwości

WiFiProperties

Właściwości

  • AllowGatewayARPPolling

    boolean opcjonalne

    Wycofane od Chrome 131

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

  • AutoConnect

    boolean opcjonalne

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

  • BSSID

    ciąg znaków opcjonalny

    Identyfikator BSSID powiązanego punktu dostępu.

  • EAP

    EAPProperties opcjonalny

    Właściwości sieci EAP. Wymagany w przypadku sieci WEP-8021X i WPA-EAP.

  • Częstotliwość

    number optional

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

  • FrequencyList

    number[] opcjonalny

    Zawiera wszystkie częstotliwości, na których ostatnio działała sieć Wi-Fi.

  • HexSSID

    ciąg znaków opcjonalny

    Kopia identyfikatora SSID sieci zakodowana w formacie szesnastkowym.

  • HiddenSSID

    boolean opcjonalne

    Określa, czy identyfikator SSID sieci będzie rozgłaszany.

  • Hasło wielowyrazowe

    ciąg znaków opcjonalny

    Chrome 66 lub nowsza wersja

    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 optional

    Wycofane, ignorowane.

  • SSID

    ciąg znaków opcjonalny

    Identyfikator SSID sieci.

  • Bezpieczeństwo

    ciąg znaków opcjonalny

    Typ zabezpieczeń sieci.

  • SignalStrength

    number optional

    siłę sygnału sieci,

WiFiStateProperties

Właściwości

WiMAXProperties

Właściwości

  • AutoConnect

    boolean opcjonalne

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

  • EAP

    EAPProperties opcjonalne

    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 pasująca skonfigurowana sieć już istnieje, ta 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

    Właściwości, za pomocą których można skonfigurować nową sieć.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: string) => void

    • wynik

      tekst

Zwroty

  • Promise<string>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 uwagę dotyczącą enableNetworkType.

Parametry

  • networkType

    Typ sieci, którą chcesz wyłączyć.

enableNetworkType()

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

Włącza wszystkie urządzenia pasujące do określonego typu sieci. Pamiętaj, że typ może reprezentować wiele typów sieci (np. „Bezprzewodowa”).

Parametry

  • networkType

    Typ sieci, którą chcesz włączyć.

forgetNetwork()

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

Zapomina konfigurację sieci, czyszcząc wszystkie skonfigurowane właściwości sieci o identyfikatorze GUID networkGuid. Może to też obejmować inne sieci z pasującymi identyfikatorami (np. identyfikator SSID i zabezpieczenia Wi-Fi). Jeśli taka konfiguracja nie istnieje, zostanie ustawiony błąd i operacja się nie powiedzie.

W sesjach kiosku ta metoda nie będzie mogła zapomnieć konfiguracji sieci współdzielonych.

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getCaptivePortalStatus()

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

Zwraca stan portalu przechwytującego dla sieci pasującej do „networkGuid”.

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: CaptivePortalStatus) => void

Zwroty

  • Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getGlobalPolicy()

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

Pobiera właściwości zasady globalnej. Te właściwości nie powinny się zmieniać podczas sesji.

Parametry

Zwroty

  • Promise<GlobalPolicy>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 ze źródeł: ustawienia użytkownika, ustawienia udostępniania, zasady dotyczące użytkowników, zasady dotyczące urządzeń i obecnie aktywne ustawienia.

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: ManagedProperties) => void

Zwroty

  • Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getNetworks()

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

Zwraca listę obiektów sieciowych o tych samych właściwościach, które są udostępniane przez getState. Filtr służy do określania typu zwracanych sieci i ograniczania ich liczby. Sieci są uporządkowane przez system na podstawie ich priorytetu, przy czym sieci połączone lub łączące się są wymienione jako pierwsze.

Parametry

Zwroty

  • Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 oraz do odczytu i zapisu).

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: NetworkProperties) => void

Zwroty

  • Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 tylko do odczytu. Ta funkcja ma być bardziej wydajna niż getProperties, która wymaga wysłania zapytania do podsystemu sieciowego i odebrania odpowiedzi. W przypadku wszystkich sieci zwracane są te właściwości: GUID, Type, Name, WiFi.Security. W przypadku widocznych sieci dostępne są dodatkowe właściwości: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parametry

Zwroty

  • Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy 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 sieci może ją zignorować. Jeśli lista zostanie zaktualizowana, zostanie wywołane zdarzenie onNetworkListChanged.

Parametry

  • networkType

    NetworkType opcjonalny

    Chrome 63 lub nowsza wersja

    Jeśli podano, żąda skanowania określonego typu. W przypadku sieci komórkowej zostanie wysłana prośba o skanowanie sieci komórkowej, jeśli jest ono obsługiwane.

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ć createNetwork. W sesjach kiosku wywołanie tej metody w sieci współdzielonej nie powiedzie się.

Parametry

  • networkGuid

    tekst

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

  • właściwości

    Właściwości do ustawienia.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

startConnect()

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

Nawiązuje połączenie z siecią o identyfikatorze networkGuid.

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

startDisconnect()

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

Rozpoczyna rozłączanie z siecią o identyfikatorze networkGuid.

Parametry

  • networkGuid

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 125 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onDeviceStateListChanged

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

Uruchamiane, 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,
)

Uruchamiane, gdy lista sieci ulegnie zmianie. Wysyła pełną listę identyfikatorów GUID wszystkich bieżących sieci.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (changes: string[]) => void

    • poniższych zmian

      string[]

onNetworksChanged

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

Uruchamiane, gdy właściwości zmienią się w dowolnej sieci. Wysyła listę identyfikatorów GUID sieci, których właściwości uległy zmianie.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (changes: string[]) => void

    • poniższych zmian

      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