chrome.networking.onc

Descrizione

L'API chrome.networking.onc viene utilizzata per configurare le connessioni di rete (cellulare, Ethernet, VPN o Wi-Fi). Questa API è disponibile nelle sessioni kiosk di Chrome OS avviate automaticamente.

Le configurazioni di connessione di rete sono specificate in base alla specifica Open Network Configuration (ONC).

NOTA: la maggior parte delle proprietà del dizionario e dei valori enum utilizza UpperCamelCase per corrispondere alla specifica ONC anziché alla convenzione lowerCamelCase di JavaScript.

Autorizzazioni

networking.onc

Disponibilità

Chrome 59+ Solo ChromeOS

Tipi

ActivationStateType

Enum

"Attivato"

"Attivazione"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Sconosciuto"

"Offline"

"Online"

"Portale"

"ProxyAuthRequired"

CellularProperties

Proprietà

  • ActivationState

    ActivationStateType facoltativo

    Stato di attivazione dell'account operatore.

  • ActivationType

    stringa facoltativa

    Il tipo di attivazione della rete mobile.

  • AllowRoaming

    booleano facoltativo

    Indica se il roaming è consentito per la rete.

  • AutoConnect

    booleano facoltativo

    Indica se la rete mobile deve essere connessa automaticamente (quando è nel raggio d'azione).

  • Famiglia

    stringa facoltativa

    Famiglia di tecnologie per dispositivi cellulari: CDMA o GSM.

  • FirmwareRevision

    stringa facoltativa

    La revisione del firmware caricata nel modem cellulare.

  • FoundNetworks

    FoundNetworkProperties[] facoltativo

    L'elenco delle reti trovate durante l'ultima scansione della rete.

  • HardwareRevision

    stringa facoltativa

    La revisione hardware del modem cellulare.

  • HomeProvider

    CellularProviderProperties facoltativo

    Informazioni sull'operatore che ha emesso la scheda SIM attualmente installata nel modem.

  • Produttore

    stringa facoltativa

    Il produttore del modem cellulare.

  • ModelID

    stringa facoltativa

    L'ID modello del modem cellulare.

  • NetworkTechnology

    stringa facoltativa

    Se il modem è registrato su una rete, la tecnologia di rete attualmente in uso.

  • PaymentPortal

    PaymentPortal facoltativo

    Portale di pagamento online che un utente può utilizzare per registrarsi o modificare un piano dati mobile.

  • RoamingState

    stringa facoltativa

    Lo stato di roaming del modem cellulare sulla rete attuale.

  • SIMLockStatus

    SIMLockStatus facoltativo

    Lo stato del blocco SIM per le reti della famiglia GSM.

  • SIMPresent

    booleano facoltativo

    Se è presente una scheda SIM.

  • Analisi in corso

    booleano facoltativo

    Chrome 63+

    True quando è in corso una scansione della rete mobile.

  • ServingOperator

    CellularProviderProperties facoltativo

    Informazioni sull'operatore sulla cui rete è attualmente registrato il modem.

  • SignalStrength

    number (facoltativo)

    L'intensità del segnale di rete attuale.

  • SupportNetworkScan

    booleano facoltativo

    Se la rete cellulare supporta la scansione.

CellularProviderProperties

Proprietà

  • Codice

    stringa

    ID rete cellulare come semplice concatenazione del codice paese mobile (MCC) e del codice di rete mobile (MNC) della rete.

  • Paese

    stringa facoltativa

    Il codice paese di due lettere.

  • Nome

    stringa

    Il nome dell'operatore.

CellularStateProperties

Proprietà

CertificatePattern

Proprietà

  • EnrollmentURI

    string[] facoltativo

    Elenco degli URI a cui l'utente può essere indirizzato nel caso in cui non vengano trovati certificati che corrispondono a questo pattern.

  • Emittente

    IssuerSubjectPattern facoltativo

    Se impostato, il pattern rispetto al quale devono corrispondere le impostazioni dell'emittente X.509.

  • IssuerCARef

    string[] facoltativo

    Elenco dei certificati CA dell'autorità di certificazione. Per corrispondere a questo pattern, un certificato deve essere firmato da una di queste autorità.

  • Oggetto

    IssuerSubjectPattern facoltativo

    Se impostato, pattern con cui devono corrispondere le impostazioni del soggetto X.509.

ClientCertificateType

Enum

"Ref"

"Pattern"

ConnectionStateType

Enum

"Connesso"

"Connessione in corso"

"NotConnected"

DeviceStateProperties

Proprietà

  • SIMLockStatus

    SIMLockStatus facoltativo

    Chrome 62+

    Lo stato di blocco della SIM se Type = Cellular e SIMPresent = True.

  • SIMPresent

    booleano facoltativo

    Chrome 62+

    Imposta lo stato di presenza della SIM se il tipo di dispositivo è cellulare.

  • Analisi in corso

    booleano facoltativo

    Imposta se il dispositivo è abilitato. True se il dispositivo sta eseguendo la scansione.

  • Lo stato attuale del dispositivo.

  • Il tipo di rete associato al dispositivo (rete cellulare, Ethernet o Wi-Fi).

DeviceStateType

Enum

"Non inizializzato"
Il dispositivo è disponibile, ma non inizializzato.

"Disattivato"
Il dispositivo è inizializzato, ma non attivato.

"Attivazione"
È stato richiesto lo stato Attivato, ma l'operazione non è stata completata.

"Attivato"
Il dispositivo è attivato.

"Vietato"
Il dispositivo è vietato.

EAPProperties

Proprietà

  • AnonymousIdentity

    stringa facoltativa

  • ClientCertPKCS11Id

    stringa facoltativa

    Chrome 60+
  • ClientCertPattern

    CertificatePattern facoltativo

  • ClientCertProvisioningProfileId

    stringa facoltativa

    Chrome 93+
  • ClientCertRef

    stringa facoltativa

  • ClientCertType

    ClientCertificateType

  • Identità

    stringa facoltativa

  • Inner

    stringa facoltativa

  • Outer

    stringa facoltativa

    Il tipo di EAP esterno. Richiesto dall'ONC, ma potrebbe non essere fornito durante la traduzione da Shill.

  • Password

    stringa facoltativa

  • SaveCredentials

    booleano facoltativo

  • ServerCAPEMs

    string[] facoltativo

  • ServerCARefs

    string[] facoltativo

  • SubjectMatch

    ManagedDOMString opzionale

    Chrome 60+
  • UseProactiveKeyCaching

    booleano facoltativo

  • UseSystemCAs

    booleano facoltativo

EthernetProperties

Proprietà

  • Autenticazione

    stringa facoltativa

    L'autenticazione utilizzata dalla rete Ethernet. I valori possibili sono None e 8021X.

  • AutoConnect

    booleano facoltativo

    Indica se la rete Ethernet deve essere connessa automaticamente.

  • EAP

    EAPProperties facoltativo

    Impostazioni EAP della rete. Obbligatorio per l'autenticazione 8021X.

EthernetStateProperties

Proprietà

FoundNetworkProperties

Proprietà

  • LongName

    stringa facoltativa

    Il nome in formato lungo dell'operatore di rete.

  • NetworkId

    stringa

    ID rete.

  • ShortName

    stringa facoltativa

    Il nome in formato breve dell'operatore di rete.

  • Stato

    stringa

    Disponibilità della rete.

  • Tecnologia

    stringa

    Tecnologia di accesso utilizzata dalla rete.

GlobalPolicy

Proprietà

  • AllowOnlyPolicyNetworksToAutoconnect

    booleano facoltativo

    Se è true, solo le reti dei criteri possono connettersi automaticamente. Il valore predefinito è false.

  • AllowOnlyPolicyNetworksToConnect

    booleano facoltativo

    Se è true, è possibile connettersi solo alle reti dei criteri e non è possibile aggiungere o configurare nuove reti. Il valore predefinito è false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    booleano facoltativo

    Chrome 70+

    Se è true e una rete gestita è disponibile nell'elenco delle reti visibili, è possibile connettersi solo alle reti dei criteri e non è possibile aggiungere o configurare nuove reti. Il valore predefinito è false.

  • BlockedHexSSIDs

    string[] facoltativo

    Chrome 86+

    Elenco delle emittenti bloccate. Sono vietate le connessioni a reti bloccate. Le reti possono essere sbloccate di nuovo specificando una configurazione di rete esplicita. Il valore predefinito è un elenco vuoto.

IPConfigProperties

Proprietà

  • ExcludedRoutes

    string[] facoltativo

    Chrome 76+

    Array di blocchi IP in notazione CIDR. Per maggiori dettagli, consulta onc_spec.md.

  • Gateway

    stringa facoltativa

    Indirizzo gateway utilizzato per la configurazione IP.

  • IPAddress

    stringa facoltativa

    L'indirizzo IP per una connessione. Può essere un indirizzo IPv4 o IPv6, a seconda del valore di Type.

  • IncludedRoutes

    string[] facoltativo

    Chrome 76+

    Array di blocchi IP in notazione CIDR. Per maggiori dettagli, consulta onc_spec.md.

  • NameServers

    string[] facoltativo

    Array di indirizzi utilizzati per i server dei nomi.

  • RoutingPrefix

    number (facoltativo)

    Il prefisso di routing.

  • SearchDomains

    string[] facoltativo

    Chrome 76+

    Array di stringhe per la risoluzione dei nomi. Per informazioni dettagliate, consulta onc_spec.md.

  • Tipo

    stringa facoltativa

    Il tipo di configurazione IP. Può essere IPv4 o IPv6.

  • WebProxyAutoDiscoveryUrl

    stringa facoltativa

    L'URL per WPAD (Web Proxy Auto-Discovery), come riportato su DHCP.

IPConfigType

Enum

"DHCP"

"Static"

IssuerSubjectPattern

Proprietà

  • CommonName

    stringa facoltativa

    Se impostato, il valore rispetto al quale confrontare il nome comune del soggetto del certificato.

  • Località

    stringa facoltativa

    Se impostato, il valore con cui confrontare la posizione comune del soggetto del certificato.

  • Organizzazione

    stringa facoltativa

    Se impostato, il valore in base al quale confrontare le organizzazioni del soggetto del certificato. Almeno un'organizzazione deve corrispondere al valore.

  • OrganizationalUnit

    stringa facoltativa

    Se impostato, il valore rispetto al quale confrontare le unità organizzative del soggetto del certificato. Almeno un'unità organizzativa deve corrispondere al valore.

ManagedBoolean

Proprietà

  • Attivo

    booleano facoltativo

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    booleano facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    booleano facoltativo

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    booleano facoltativo

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    booleano facoltativo

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedCellularProperties

Proprietà

ManagedDOMString

Proprietà

  • Attivo

    stringa facoltativa

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    stringa facoltativa

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    stringa facoltativa

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    stringa facoltativa

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    stringa facoltativa

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedDOMStringList

Proprietà

  • Attivo

    string[] facoltativo

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    string[] facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    string[] facoltativo

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    string[] facoltativo

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    string[] facoltativo

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedEthernetProperties

Proprietà

ManagedIPConfigProperties

Proprietà

ManagedIPConfigType

Proprietà

  • Attivo

    IPConfigType facoltativo

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    IPConfigType facoltativo

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    IPConfigType facoltativo

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedLong

Proprietà

  • Attivo

    number (facoltativo)

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    number (facoltativo)

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    number (facoltativo)

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    number (facoltativo)

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    number (facoltativo)

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedManualProxySettings

Proprietà

ManagedProperties

Proprietà

ManagedProxyLocation

Proprietà

ManagedProxySettings

Proprietà

ManagedProxySettingsType

Proprietà

  • Attivo

    ProxySettingsType facoltativo

    Il valore attivo attualmente utilizzato dal gestore della configurazione di rete (ad es. Shill).

  • DeviceEditable

    booleano facoltativo

    Indica se esiste un DevicePolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato per il criterio). Il valore predefinito è false.

  • DevicePolicy

    ProxySettingsType facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Efficace

    stringa facoltativa

    L'origine da cui è stato determinato il valore effettivo della proprietà.

  • SharedSetting

    ProxySettingsType facoltativo

    Il valore impostato per tutti gli utenti del dispositivo. Fornito solo se DeviceEditiable è true.

  • UserEditable

    booleano facoltativo

    Indica se esiste una UserPolicy per la proprietà e se consente la modifica della proprietà (ovvero il valore della proprietà consigliato impostato dalle norme). Il valore predefinito è false.

  • UserPolicy

    ProxySettingsType facoltativo

    Il valore della proprietà fornito dalle norme utente.

  • UserSetting

    ProxySettingsType facoltativo

    Il valore della proprietà impostato dall'utente che ha eseguito l'accesso. Fornito solo se UserEditable è true.

ManagedThirdPartyVPNProperties

Proprietà

ManagedVPNProperties

Proprietà

ManagedWiFiProperties

Proprietà

ManualProxySettings

Proprietà

  • FTPProxy

    ProxyLocation facoltativo

    Impostazioni del proxy FTP.

  • HTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP.

  • SOCKS

    ProxyLocation facoltativo

    Impostazioni per il proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP sicuro.

NetworkConfigProperties

Proprietà

NetworkFilter

Proprietà

  • configurato

    booleano facoltativo

    Se è vero, includi solo le reti configurate (salvate). Il valore predefinito è "false".

  • limite

    number (facoltativo)

    Il numero massimo di reti da restituire. Se non specificato, il valore predefinito è 1000. Utilizza 0 per nessun limite.

  • networkType

    NetworkType

    Il tipo di reti da restituire.

  • visibile

    booleano facoltativo

    Se è true, includi solo le reti visibili (fisicamente connesse o nel raggio d'azione). Il valore predefinito è "false".

NetworkProperties

Proprietà

  • Cellulare

    CellularProperties facoltativo

    Per le reti mobili, le proprietà delle reti mobili.

  • Collegabile

    booleano facoltativo

    Se la rete è connettibile.

  • ConnectionState

    ConnectionStateType facoltativo

    Lo stato attuale della connessione della rete.

  • ErrorState

    stringa facoltativa

    L'ultimo stato di errore di rete registrato.

  • Ethernet

    EthernetProperties facoltativo

    Per le reti Ethernet, le proprietà della rete Ethernet.

  • GUID

    stringa

    Il GUID di rete.

  • IPAddressConfigType

    IPConfigType facoltativo

    Il tipo di configurazione dell'indirizzo IP della rete.

  • IPConfigs

    IPConfigProperties[] facoltativo

    La configurazione IP della rete.

  • MacAddress

    stringa facoltativa

    L'indirizzo MAC della rete.

  • A consumo

    booleano facoltativo

    Chrome 85+

    Indica se la rete è a consumo.

  • Nome

    stringa facoltativa

    Un nome di rete facile da usare.

  • NameServersConfigType

    IPConfigType facoltativo

    Il tipo di configurazione IP per i server dei nomi utilizzati dalla rete.

  • Priorità

    number (facoltativo)

    La priorità di rete.

  • ProxySettings

    ProxySettings facoltativo

    Le impostazioni proxy della rete.

  • RestrictedConnectivity

    booleano facoltativo

    Per una rete connessa, se la connettività di rete a internet è limitata, ad esempio se la rete si trova dietro un portale o se una rete mobile non è attivata.

  • SavedIPConfig

    IPConfigProperties facoltativo

    Configurazione IP ricevuta dal server DHCP prima dell'applicazione della configurazione IP statica.

  • Origine

    stringa facoltativa

    Indica se e come è configurata la rete. I valori possibili sono:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" è in conflitto con la generazione del codice di estensione, quindi dobbiamo utilizzare una stringa per "Source" anziché un'enumerazione SourceType.

  • StaticIPConfig

    IPConfigProperties facoltativo

    La configurazione IP statico della rete.

  • TrafficCounterResetTime

    number (facoltativo)

    Chrome 125+

    Data dell'ultimo ripristino dei contatori di traffico.

  • Il tipo di rete.

  • VPN

    VPNProperties facoltativo

    Per le reti VPN, le proprietà VPN della rete.

  • Wi-Fi

    WiFiProperties facoltativo

    Per le reti Wi-Fi, le proprietà Wi-Fi della rete.

NetworkStateProperties

Proprietà

NetworkType

Enum

"Tutti"

"Cellulare"

"Ethernet"

"Tether"

"VPN"

"Wireless"

"Wi-Fi"

PaymentPortal

Proprietà

  • Metodo

    stringa

    Il metodo HTTP da utilizzare per il portale di pagamento.

  • PostData

    stringa facoltativa

    I dati POST da inviare al portale di pagamento. Ignorato a meno che Method non sia POST.

  • URL

    stringa facoltativa

    L'URL del portale di pagamento.

ProxyLocation

Proprietà

  • Host

    stringa

    L'host dell'indirizzo IP del proxy.

  • Porta

    numero

    La porta da utilizzare per il proxy.

ProxySettings

Proprietà

  • ExcludeDomains

    string[] facoltativo

    Domini e host per i quali sono escluse le impostazioni proxy manuali.

  • Manuale

    ManualProxySettings facoltativo

    Impostazioni proxy manuali: utilizzate solo per le impostazioni proxy di Manual.

  • PAC

    stringa facoltativa

    URL del file di configurazione automatica del proxy.

  • Il tipo di impostazioni proxy.

ProxySettingsType

Enum

"Direct"

"Manuale"

"PAC"

"WPAD"

SIMLockStatus

Proprietà

  • LockEnabled

    booleano

    Indica se il blocco SIM è abilitato.

  • LockType

    stringa

    Lo stato del blocco SIM. I valori possibili sono 'sim-pin', 'sim-puk' e ''.

  • RetriesLeft

    number (facoltativo)

    Numero di tentativi di blocco del PIN consentiti prima che sia necessario il PUK per sbloccare la SIM.

ThirdPartyVPNProperties

Proprietà

  • ExtensionID

    stringa

    ID dell'estensione del fornitore di VPN di terze parti.

  • ProviderName

    stringa facoltativa

    Il nome del provider VPN.

VPNProperties

Proprietà

  • AutoConnect

    booleano facoltativo

    Indica se la rete VPN deve essere connessa automaticamente.

  • Host

    stringa facoltativa

    L'host VPN.

  • Tipo

    stringa facoltativa

    Il tipo di VPN. Non può essere un'enumerazione a causa di "L2TP-IPSec". Questo parametro è facoltativo per NetworkConfigProperties, che viene passato a setProperties e può essere utilizzato per impostare solo proprietà specifiche.

VPNStateProperties

Proprietà

WiFiProperties

Proprietà

  • AllowGatewayARPPolling

    booleano facoltativo

    Ritirato a partire da Chrome 131

    Rimosso nella versione M131. Al momento non è attivo alcun polling ARP.

  • AutoConnect

    booleano facoltativo

    Indica se la rete Wi-Fi deve essere connessa automaticamente quando è nel raggio d'azione.

  • BSSID

    stringa facoltativa

    Il BSSID del punto di accesso associato.

  • EAP

    EAPProperties facoltativo

    Le proprietà EAP della rete. Obbligatorio per le emittenti WEP-8021X e WPA-EAP.

  • Frequenza

    number (facoltativo)

    La frequenza operativa del servizio Wi-Fi in MHz. Per le reti connesse, la frequenza attuale a cui è connessa la rete. In caso contrario, la frequenza del BSS migliore disponibile.

  • FrequencyList

    number[] facoltativo

    Contiene tutte le frequenze operative visualizzate di recente per la rete Wi-Fi.

  • HexSSID

    stringa facoltativa

    Copia con codifica esadecimale dell'SSID della rete.

  • HiddenSSID

    booleano facoltativo

    Indica se l'SSID della rete verrà trasmesso.

  • Passphrase

    stringa facoltativa

    Chrome 66+

    La passphrase per le connessioni WEP/WPA/WPA2. Questa proprietà può essere impostata solo. Le proprietà restituite da getProperties non conterranno questo valore.

  • RoamThreshold

    number (facoltativo)

    Deprecato, ignorato.

  • SSID

    stringa facoltativa

    L'SSID della rete.

  • Sicurezza

    stringa facoltativa

    Il tipo di sicurezza della rete.

  • SignalStrength

    number (facoltativo)

    L'intensità del segnale della rete.

WiFiStateProperties

Proprietà

WiMAXProperties

Proprietà

  • AutoConnect

    booleano facoltativo

    Indica se la rete deve essere connessa automaticamente.

  • EAP

    EAPProperties facoltativo

    Le proprietà EAP della rete.

Metodi

createNetwork()

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

Crea una nuova configurazione di rete dalle proprietà. Se esiste già una rete configurata corrispondente, l'operazione non riuscirà. In caso contrario, restituisce il GUID della nuova rete.

Parametri

  • condiviso

    booleano

    Se true, condividi questa configurazione di rete con altri utenti.

    Questa opzione è esposta solo all'interfaccia utente web di Chrome.* Quando viene chiamato dalle app, false è l'unico valore consentito.

  • Le proprietà per configurare la nuova rete.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: string) => void

    • risultato

      stringa

Resi

  • Promise<string>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

disableNetworkType()

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

Disattiva tutti i dispositivi che corrispondono al tipo di rete specificato. Vedi nota per enableNetworkType.

Parametri

  • networkType

    NetworkType

    Il tipo di rete da disattivare.

enableNetworkType()

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

Attiva tutti i dispositivi che corrispondono al tipo di rete specificato. Tieni presente che il tipo potrebbe rappresentare più tipi di rete (ad es. "Wireless").

Parametri

forgetNetwork()

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

Dimentica una configurazione di rete cancellando tutte le proprietà configurate per la rete con GUID networkGuid. Potrebbero essere incluse anche altre reti con identificatori corrispondenti (ad es. SSID e sicurezza Wi-Fi). Se non esiste una configurazione di questo tipo, verrà impostato un errore e l'operazione non andrà a buon fine.

Nelle sessioni kiosk, questo metodo non sarà in grado di dimenticare le configurazioni di rete condivise.

Parametri

  • networkGuid

    stringa

    Il GUID della rete da eliminare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getCaptivePortalStatus()

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

Restituisce lo stato del captive portal per la rete corrispondente a "networkGuid".

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui ottenere lo stato del captive portal.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: CaptivePortalStatus) => void

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getDeviceStates()

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

Restituisce gli stati dei dispositivi di rete disponibili.

Parametri

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getGlobalPolicy()

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

Ottiene le proprietà del criterio globale. Queste proprietà non dovrebbero cambiare durante una sessione.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: GlobalPolicy) => void

Resi

  • Promise<GlobalPolicy>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getManagedProperties()

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

Recupera le proprietà unite della rete con ID networkGuid dalle origini: impostazioni utente, impostazioni condivise, criteri utente, criteri dispositivo e impostazioni attualmente attive.

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui ottenere le proprietà.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ManagedProperties) => void

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getNetworks()

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

Restituisce un elenco di oggetti di rete con le stesse proprietà fornite da getState. Viene fornito un filtro per specificare il tipo di reti restituite e per limitare il numero di reti. Le reti vengono ordinate dal sistema in base alla priorità, con le reti connesse o in fase di connessione elencate per prime.

Parametri

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getProperties()

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

Recupera tutte le proprietà della rete con ID networkGuid. Include tutte le proprietà della rete (valori di sola lettura e lettura/scrittura).

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui ottenere le proprietà.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkProperties) => void

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

getState()

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

Recupera le proprietà di sola lettura memorizzate nella cache della rete con ID networkGuid. Questa funzione è pensata per offrire prestazioni migliori rispetto a getProperties, che richiede un round trip per eseguire query sul sottosistema di rete. Per tutte le reti vengono restituite le seguenti proprietà: GUID, Type, Name, WiFi.Security. Per le reti visibili vengono fornite proprietà aggiuntive: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui ottenere le proprietà.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkStateProperties) => void

Resi

  • Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

requestNetworkScan()

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

Richiede al sottosistema di rete di cercare nuove reti e aggiornare l'elenco restituito da getVisibleNetworks. Si tratta solo di una richiesta: il sottosistema di rete può scegliere di ignorarla. Se l'elenco viene aggiornato, viene attivato l'evento onNetworkListChanged.

Parametri

  • networkType

    NetworkType facoltativo

    Chrome 63+

    Se fornito, richiede una scansione specifica per il tipo. Per la rete mobile, verrà richiesta una scansione della rete mobile, se supportata.

setProperties()

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

Imposta le proprietà della rete con ID networkGuid. Questo valore è valido solo per le reti configurate (Source != None). Le reti visibili non configurate devono utilizzare createNetwork. Nelle sessioni kiosk, la chiamata di questo metodo su una rete condivisa non andrà a buon fine.

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui impostare le proprietà.

  • Le proprietà da impostare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

startConnect()

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

Avvia una connessione alla rete con networkGuid.

Parametri

  • networkGuid

    stringa

    Il GUID della rete a cui connettersi.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

startDisconnect()

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

Avvia una disconnessione dalla rete con networkGuid.

Parametri

  • networkGuid

    stringa

    Il GUID della rete da cui disconnettersi.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

Eventi

onDeviceStateListChanged

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

Attivato quando l'elenco dei dispositivi è cambiato o quando sono state modificate le proprietà dello stato di un dispositivo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void

onNetworkListChanged

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

Attivato quando l'elenco delle emittenti è cambiato. Invia un elenco completo di GUID per tutte le reti attuali.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (changes: string[]) => void

    • modifiche

      string[]

onNetworksChanged

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

Attivato quando le proprietà cambiano in una delle reti. Invia un elenco di GUID per le emittenti le cui proprietà sono cambiate.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (changes: string[]) => void

    • modifiche

      string[]

onPortalDetectionCompleted

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

Attivato al termine del rilevamento di un captive portal per una rete. Invia il GUID della rete e lo stato del captive portal corrispondente.

Parametri