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 con avvio automatico.

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 e versioni successive Solo ChromeOS

Tipi

ActivationStateType

Enum

"Attivato"

"Attivazione in corso"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Sconosciuto"

"Offline"

"Online"

"Portale"

"ProxyAuthRequired"

CellularProperties

Proprietà

  • ActivationState

    ActivationStateType facoltativo

    Stato di attivazione dell'account dell'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 collegata automaticamente (se in portata).

  • Famiglia

    stringa facoltativa

    Famiglia di tecnologia del dispositivo cellulare: CDMA o GSM.

  • FirmwareRevision

    stringa facoltativa

    La revisione del firmware caricata nel modem cellulare.

  • FoundNetworks

    FoundNetworkProperties[] facoltativo

    L'elenco delle reti trovate durante la scansione di rete più recente.

  • 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 sottoscrivere o modificare un piano di dati mobili.

  • RoamingState

    stringa facoltativa

    Lo stato del roaming del modem cellulare sulla rete attuale.

  • SIMLockStatus

    SIMLockStatus facoltativo

    Lo stato del blocco della SIM per le reti di famiglie GSM.

  • SIMPresent

    booleano facoltativo

    Indica se è presente una scheda SIM.

  • Analisi in corso

    booleano facoltativo

    Chrome 63 e versioni successive

    True quando è in corso una ricerca della rete mobile.

  • ServingOperator

    CellularProviderProperties facoltativo

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

  • SignalStrength

    number facoltativo

    L'intensità del segnale di rete attuale.

  • SupportNetworkScan

    booleano facoltativo

    Se la rete mobile supporta la scansione.

CellularProviderProperties

Proprietà

  • Codice

    stringa

    L'ID rete mobile come semplice concatenazione del codice paese mobile (MCC) e del codice 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

    stringa[] facoltativo

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

  • Emittente

    IssuerSubjectPattern facoltativo

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

  • IssuerCARef

    stringa[] facoltativo

    Elenco dei certificati CA dell'emittente del certificato. Un certificato deve essere firmato da una di queste autorità per corrispondere a questo pattern.

  • Oggetto

    IssuerSubjectPattern facoltativo

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

ClientCertificateType

Enum

"Ref"

"Pattern"

ConnectionStateType

Enum

"Connesso"

"Connessione"

"NotConnected"

DeviceStateProperties

Proprietà

  • SIMLockStatus

    SIMLockStatus facoltativo

    Chrome 62 e versioni successive

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

  • SIMPresent

    booleano facoltativo

    Chrome 62 e versioni successive

    Impostato sullo stato della SIM presente se il tipo di dispositivo è Cellulare.

  • Analisi in corso

    booleano facoltativo

    Imposta se il dispositivo è abilitato. True se il dispositivo è attualmente in fase di scansione.

  • Lo stato attuale del dispositivo.

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

DeviceStateType

Enum

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

"Disattivato"
Il dispositivo è stato inizializzato, ma non è attivo.

"Attivazione"
Lo stato Attivato è stato richiesto, ma non è stato completato.

"Attivato"
Il dispositivo è attivo.

"Proibito"
Il dispositivo è vietato.

EAPProperties

Proprietà

  • AnonymousIdentity

    stringa facoltativa

  • ClientCertPKCS11Id

    stringa facoltativa

    Chrome 60 o versioni successive
  • ClientCertPattern

    CertificatePattern facoltativo

  • ClientCertProvisioningProfileId

    stringa facoltativa

    Chrome 93 e versioni successive
  • ClientCertRef

    stringa facoltativa

  • ClientCertType

    ClientCertificateType

  • Identità

    stringa facoltativa

  • Inner

    stringa facoltativa

  • Outer

    stringa facoltativa

    Il tipo di EAP esterno. Obbligatorio per ONC, ma potrebbe non essere fornito durante la traduzione da Shill.

  • Password

    stringa facoltativa

  • SaveCredentials

    booleano facoltativo

  • ServerCAPEMs

    stringa[] facoltativo

  • ServerCARefs

    stringa[] facoltativo

  • SubjectMatch

    ManagedDOMString facoltativo

    Chrome 60 o versioni successive
  • 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 nel 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

    La 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 di criteri e non è possibile aggiungere o configurare nuove reti. Il valore predefinito è false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    booleano facoltativo

    Chrome 70 o versioni successive

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

  • BlockedHexSSIDs

    stringa[] facoltativo

    Chrome 86 e versioni successive

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

IPConfigProperties

Proprietà

  • ExcludedRoutes

    stringa[] facoltativo

    Chrome 76 e versioni successive

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

  • Gateway

    stringa facoltativa

    Indirizzo del gateway utilizzato per la configurazione IP.

  • IPAddress

    stringa facoltativa

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

  • IncludedRoutes

    stringa[] facoltativo

    Chrome 76 e versioni successive

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

  • NameServers

    stringa[] facoltativo

    Array di indirizzi utilizzati per i server dei nomi.

  • RoutingPrefix

    number facoltativo

    Il prefisso di routing.

  • SearchDomains

    stringa[] facoltativo

    Chrome 76 e versioni successive

    Array di stringhe per la risoluzione dei nomi. Per maggiori dettagli, consulta onc_spec.md.

  • Tipo

    stringa facoltativa

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

  • WebProxyAutoDiscoveryUrl

    stringa facoltativa

    L'URL per il rilevamento automatico del proxy web, come indicato tramite DHCP.

IPConfigType

Enum

"DHCP"

"Static"

IssuerSubjectPattern

Proprietà

  • CommonName

    stringa facoltativa

    Se impostato, il valore in base al quale viene effettuata la corrispondenza del nome comune del soggetto del certificato.

  • Località

    stringa facoltativa

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

  • Organizzazione

    stringa facoltativa

    Se impostato, il valore in base al quale eseguire la corrispondenza delle organizzazioni del soggetto del certificato. Almeno un'organizzazione deve corrispondere al valore.

  • OrganizationalUnit

    stringa facoltativa

    Se impostato, il valore in base al quale eseguire la corrispondenza delle 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 criterio DevicePolicy per la proprietà e se consente di modificarla (ovvero il valore della proprietà consigliato impostato dal criterio). Il valore predefinito è false.

  • DevicePolicy

    booleano facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    booleano facoltativo

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    booleano facoltativo

    Il valore della proprietà fornito dal criterio 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 criterio DevicePolicy per la proprietà e se consente di modificarla (ovvero il valore della proprietà consigliato impostato dal criterio). Il valore predefinito è false.

  • DevicePolicy

    stringa facoltativa

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    stringa facoltativa

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    stringa facoltativa

    Il valore della proprietà fornito dal criterio utente.

  • UserSetting

    stringa facoltativa

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

ManagedDOMStringList

Proprietà

  • Attivo

    stringa[] facoltativo

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

  • DeviceEditable

    booleano facoltativo

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

  • DevicePolicy

    stringa[] facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    stringa[] facoltativo

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    stringa[] facoltativo

    Il valore della proprietà fornito dal criterio utente.

  • UserSetting

    stringa[] 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 criterio DevicePolicy per la proprietà e se consente di modificarla (ovvero il valore della proprietà consigliato impostato dal criterio). Il valore predefinito è false.

  • DevicePolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    IPConfigType facoltativo

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dal criterio 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 criterio DevicePolicy per la proprietà e se consente di modificarla (ovvero il valore della proprietà consigliato impostato dal criterio). Il valore predefinito è false.

  • DevicePolicy

    number facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    number facoltativo

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    number facoltativo

    Il valore della proprietà fornito dal criterio 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 criterio DevicePolicy per la proprietà e se consente di modificarla (ovvero il valore della proprietà consigliato impostato dal criterio). Il valore predefinito è false.

  • DevicePolicy

    ProxySettingsType facoltativo

    Il valore della proprietà fornito dal criterio del dispositivo.

  • Valida

    stringa facoltativa

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

  • SharedSetting

    ProxySettingsType facoltativo

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

  • UserEditable

    booleano facoltativo

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

  • UserPolicy

    ProxySettingsType facoltativo

    Il valore della proprietà fornito dal criterio 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 per il proxy FTP.

  • HTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP.

  • CALZE

    ProxyLocation facoltativo

    Impostazioni per il proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP sicuro.

NetworkConfigProperties

Proprietà

NetworkFilter

Proprietà

  • configurato

    booleano facoltativo

    Se true, vengono incluse solo le emittenti 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 non specificare un limite.

  • networkType

    NetworkType

    Il tipo di emittenti da restituire.

  • visibile

    booleano facoltativo

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

NetworkProperties

Proprietà

  • Cellulare

    CellularProperties facoltativo

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

  • Collegabile

    booleano facoltativo

    Indica se la rete è connettibile.

  • ConnectionState

    ConnectionStateType facoltativo

    Lo stato attuale della connessione di 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 della 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 e versioni successive

    Indica se la rete è a consumo.

  • Nome

    stringa facoltativa

    Un nome della rete facile da ricordare.

  • NameServersConfigType

    IPConfigType facoltativo

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

  • Priorità

    number facoltativo

    La priorità della rete.

  • ProxySettings

    ProxySettings facoltativo

    Le impostazioni del proxy della rete.

  • RestrictedConnectivity

    booleano facoltativo

    Per una rete connessa, se la connettività della rete a internet è limitata, ad esempio se la rete è protetta da 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

    "Nessuna" è in conflitto con la generazione del codice dell'estensione, pertanto dobbiamo utilizzare una stringa per "Origine" anziché un enum SourceType.

  • StaticIPConfig

    IPConfigProperties facoltativo

    La configurazione IP statica della rete.

  • TrafficCounterResetTime

    number facoltativo

    Chrome 125 e versioni successive

    Data dell'ultima reimpostazione 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"

"Esegui il tethering"

"VPN"

"Wireless"

"Wi-Fi"

PaymentPortal

Proprietà

  • Metodo

    stringa

    Il metodo HTTP da utilizzare per il portale di pagamento.

  • PostData

    stringa facoltativa

    I dati del post da inviare al portale di pagamento. Viene 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

    stringa[] facoltativo

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

  • 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

"Diretta"

"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 PIN consentiti prima che sia necessario il PUK per sbloccare la SIM.

ThirdPartyVPNProperties

Proprietà

  • ExtensionID

    stringa

    ID dell'estensione del provider 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 enum a causa di "L2TP-IPSec". Questo valore è 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 da Chrome 131

    Rimosso in M131. Al momento non è attivo alcun sondaggio ARP.

  • AutoConnect

    booleano facoltativo

    Indica se la rete Wi-Fi deve essere connessa automaticamente quando è in portata.

  • BSSID

    stringa facoltativa

    Il BSSID del punto di accesso associato.

  • EAP

    EAPProperties facoltativo

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

  • Frequenza

    number facoltativo

    La frequenza di funzionamento del servizio Wi-Fi in MHz. Per le reti connesse, la frequenza corrente su cui è connessa la rete. In caso contrario, la frequenza del BSS migliore disponibile.

  • FrequencyList

    number[] facoltativo

    Contiene tutte le frequenze di funzionamento rilevate di recente per la rete Wi-Fi.

  • HexSSID

    stringa facoltativa

    Copia codificata esadecimale dell'SSID della rete.

  • HiddenSSID

    booleano facoltativo

    Indica se l'SSID della rete verrà trasmesso.

  • Passphrase

    stringa facoltativa

    Chrome 66 e versioni successive

    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

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

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

Parametri

  • condiviso

    booleano

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

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

  • Le proprietà con cui configurare la nuova rete.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: string) => void

    • risultato

      stringa

Resi

  • Promise<string>

    Chrome 125 e versioni successive

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

disableNetworkType()

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

Disattiva tutti i dispositivi corrispondenti al tipo di rete specificato. Vedi la nota relativa a enableNetworkType.

Parametri

  • networkType

    NetworkType

    Il tipo di rete da disattivare.

enableNetworkType()

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

Consente tutti i dispositivi corrispondenti 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,
)

Elimina una configurazione di rete cancellando tutte le proprietà configurate per la rete con il 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 potrà eliminare le configurazioni di rete condivise.

Parametri

  • networkGuid

    stringa

    Il GUID della rete da eliminare.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

getCaptivePortalStatus()

Promessa 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

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

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: CaptivePortalStatus) => void

Resi

  • Chrome 125 e versioni successive

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

getDeviceStates()

Promessa 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

Restituisce gli stati dei dispositivi di rete disponibili.

Parametri

Resi

  • Chrome 125 e versioni successive

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

getGlobalPolicy()

Promessa 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

Recupera le proprietà dei criteri globali. Non è previsto che queste proprietà cambino durante una sessione.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: GlobalPolicy) => void

Resi

  • Promise<GlobalPolicy>

    Chrome 125 e versioni successive

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

getManagedProperties()

Promessa 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

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

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui recuperare le proprietà.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: ManagedProperties) => void

Resi

  • Chrome 125 e versioni successive

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

getNetworks()

Promessa 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

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

Parametri

Resi

  • Chrome 125 e versioni successive

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

getProperties()

Promessa 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

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

Parametri

  • networkGuid

    stringa

    Il GUID della rete per cui recuperare le proprietà.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkProperties) => void

Resi

  • Chrome 125 e versioni successive

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

getState()

Promessa 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

Recupera le proprietà di sola lettura memorizzate nella cache della rete con ID networkGuid. Si tratta di una funzione con prestazioni superiori rispetto a getProperties, che richiede un viaggio di andata e ritorno 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 recuperare le proprietà.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkStateProperties) => void

Resi

  • Chrome 125 e versioni successive

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

requestNetworkScan()

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

Richiede al sottosistema di rete di cercare nuove reti e di 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 e versioni successive

    Se specificato, richiede una scansione specifica per il tipo. Per il servizio cellulare, se supportato, verrà richiesta una ricerca della rete mobile.

setProperties()

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

Imposta le proprietà della rete con ID networkGuid. Questo vale solo per le emittenti configurate (Source != None). Per le reti visibili non configurate, utilizza invece createNetwork. Nelle sessioni kiosk, la chiamata a 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

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

startConnect()

Promessa 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

Avvia una connessione alla rete con networkGuid.

Parametri

  • networkGuid

    stringa

    Il GUID della rete a cui connetterti.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

startDisconnect()

Promessa 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

Avvia una disconnessione dalla rete con networkGuid.

Parametri

  • networkGuid

    stringa

    Il GUID della rete da cui disconnettersi.

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

Eventi

onDeviceStateListChanged

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

Viene attivato quando l'elenco dei dispositivi è cambiato o quando sono cambiate le proprietà dello stato del dispositivo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    () => void

onNetworkListChanged

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

Viene attivato quando l'elenco delle emittenti è cambiato. Invia un elenco completo dei GUID per tutte le emittenti attuali.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (changes: string[]) => void

    • modifiche

      stringa[]

onNetworksChanged

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

Viene attivato quando le proprietà cambiano in una delle reti. Invia un elenco di GUID per le emittenti di cui sono state modificate le proprietà.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (changes: string[]) => void

    • modifiche

      stringa[]

onPortalDetectionCompleted

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

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

Parametri