chrome.networking.onc

Descrizione

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

Le configurazioni delle connessioni di rete vengono specificate in base alla specifica Open Network Configuration (ONC).

NOTE: 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"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Sconosciuto"

"Offline"

"Online"

"Portal"

"ProxyAuthRequired"

CellularProperties

Proprietà

  • ActivationState

    ActivationStateType facoltativo

    Stato di attivazione dell'account dell'operatore.

  • ActivationType

    stringa facoltativa

    Il tipo di attivazione della rete mobile.

  • AllowRoaming

    boolean facoltativo

    Indica se il roaming è consentito per la rete.

  • AutoConnect

    boolean facoltativo

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

  • Famiglia

    stringa facoltativa

    Famiglia di tecnologie per dispositivi mobili: CDMA o GSM.

  • FirmwareRevision

    stringa facoltativa

    La revisione del firmware caricata nel modem di rete dati.

  • FoundNetworks

    FoundNetworkProperties[] facoltativo

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

  • HardwareRevision

    stringa facoltativa

    La revisione hardware del modem di rete dati.

  • 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 di rete dati.

  • 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 a un piano dati mobile o modificarlo.

  • RoamingState

    stringa facoltativa

    Lo stato di roaming del modem di rete dati sulla rete attuale.

  • SIMLockStatus

    SIMLockStatus facoltativo

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

  • SIMPresent

    boolean facoltativo

    Se è presente una scheda SIM.

  • Analisi in corso

    boolean facoltativo

    Chrome 63 e versioni successive

    True quando è in corso una scansione della rete mobile.

  • ServingOperator

    CellularProviderProperties facoltativo

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

  • SignalStrength

    number optional

    L'intensità del segnale di rete attuale.

  • SupportNetworkScan

    boolean facoltativo

    Se la rete mobile supporta la scansione.

CellularProviderProperties

Proprietà

  • Codice

    stringa

    ID della rete mobile come semplice concatenazione del Mobile Country Code (MCC) e del Mobile Network Code (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 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 con cui devono essere confrontate le impostazioni dell'emittente X.509.

  • IssuerCARef

    string[] 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 con cui devono essere confrontate le impostazioni dell'oggetto X.509.

ClientCertificateType

Enum

"Ref"

"Pattern"

ConnectionStateType

Enum

"Connesso"

"Connessione in corso…"

"NotConnected"

DeviceStateProperties

Proprietà

  • SIMLockStatus

    SIMLockStatus facoltativo

    Chrome 62 e versioni successive

    Lo stato del blocco SIM se Tipo = Rete mobile e SIMPresent = True.

  • SIMPresent

    boolean facoltativo

    Chrome 62 e versioni successive

    Impostato sullo stato di presenza della SIM se il tipo di dispositivo è cellulare.

  • Analisi in corso

    boolean facoltativo

    Imposta se il dispositivo è attivo. 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 inizializzato.

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

"Abilitazione"
È stato richiesto lo stato Abilitato, ma non è stato completato.

"Attivato"
Il dispositivo è attivato.

"Prohibited"
Il dispositivo è vietato.

EAPProperties

Proprietà

  • AnonymousIdentity

    stringa facoltativa

  • ClientCertPKCS11Id

    stringa facoltativa

    Chrome 60+
  • 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. Richiesto da ONC, ma potrebbe non essere fornito durante la traduzione da Shill.

  • Password

    stringa facoltativa

  • SaveCredentials

    boolean facoltativo

  • ServerCAPEMs

    string[] facoltativo

  • ServerCARefs

    string[] facoltativo

  • SubjectMatch

    ManagedDOMString facoltativo

    Chrome 60+
  • UseProactiveKeyCaching

    boolean facoltativo

  • UseSystemCAs

    boolean facoltativo

EthernetProperties

Proprietà

  • Autenticazione

    stringa facoltativa

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

  • AutoConnect

    boolean 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 esteso 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

    boolean facoltativo

    Se impostato su true, solo le reti con policy possono connettersi automaticamente. Il valore predefinito è false.

  • AllowOnlyPolicyNetworksToConnect

    boolean facoltativo

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean facoltativo

    Chrome 70 e versioni successive

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

  • BlockedHexSSIDs

    string[] facoltativo

    Chrome 86 e versioni successive

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

IPConfigProperties

Proprietà

  • ExcludedRoutes

    string[] facoltativo

    Chrome 76 e versioni successive

    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 di una connessione. Può essere un indirizzo IPv4 o IPv6, a seconda del valore di Type.

  • IncludedRoutes

    string[] facoltativo

    Chrome 76 e versioni successive

    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 optional

    Il prefisso di routing.

  • SearchDomains

    string[] facoltativo

    Chrome 76 e versioni successive

    Array di stringhe per la risoluzione dei nomi. Per i dettagli, 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 segnalato tramite DHCP.

IPConfigType

Enum

"DHCP"

"Statico"

IssuerSubjectPattern

Proprietà

  • CommonName

    stringa facoltativa

    Se impostato, il valore con cui deve corrispondere il nome comune del soggetto del certificato.

  • Località

    stringa facoltativa

    Se impostato, il valore rispetto al quale deve essere verificata la corrispondenza della località comune del soggetto del certificato.

  • Organizzazione

    stringa facoltativa

    Se impostato, il valore rispetto al quale trovare una corrispondenza con le organizzazioni del soggetto del certificato. Almeno un'organizzazione deve corrispondere al valore.

  • OrganizationalUnit

    stringa facoltativa

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

ManagedBoolean

Proprietà

  • Attivo

    boolean facoltativo

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

  • DeviceEditable

    boolean facoltativo

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

  • DevicePolicy

    boolean facoltativo

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    boolean facoltativo

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • UserPolicy

    boolean facoltativo

    Il valore della proprietà fornito dal criterio utente.

  • UserSetting

    boolean 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

    boolean facoltativo

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

  • DevicePolicy

    stringa facoltativa

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    stringa facoltativa

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). 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

    string[] facoltativo

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

  • DeviceEditable

    boolean facoltativo

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

  • DevicePolicy

    string[] facoltativo

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    string[] facoltativo

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • UserPolicy

    string[] facoltativo

    Il valore della proprietà fornito dal criterio 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

    boolean facoltativo

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

  • DevicePolicy

    IPConfigType facoltativo

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    IPConfigType facoltativo

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). 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 optional

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

  • DeviceEditable

    boolean facoltativo

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

  • DevicePolicy

    number optional

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    number optional

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). Il valore predefinito è false.

  • UserPolicy

    number optional

    Il valore della proprietà fornito dal criterio utente.

  • UserSetting

    number optional

    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

    boolean facoltativo

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

  • DevicePolicy

    ProxySettingsType facoltativo

    Il valore della proprietà fornito dalla policy per i dispositivi.

  • Efficace

    stringa facoltativa

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

  • SharedSetting

    ProxySettingsType facoltativo

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

  • UserEditable

    boolean facoltativo

    Se esiste un criterio UserPolicy per la proprietà e consente di modificarla (ovvero il criterio imposta il valore della proprietà consigliato). 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.

  • SOCKS

    ProxyLocation facoltativo

    Impostazioni per il proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facoltativo

    Impostazioni per il proxy HTTP sicuro.

NetworkConfigProperties

Proprietà

NetworkFilter

Proprietà

  • configurato

    boolean facoltativo

    Se impostato su true, include solo le reti configurate (salvate). Il valore predefinito è "false".

  • limite

    number optional

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

  • networkType

    NetworkType

    Il tipo di reti da restituire.

  • visibile

    boolean facoltativo

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

NetworkProperties

Proprietà

  • Cellulare

    CellularProperties facoltativo

    Per le reti mobili, le proprietà della rete mobile.

  • Collegabile

    boolean facoltativo

    Se la rete è collegabile.

  • ConnectionState

    ConnectionStateType facoltativo

    Lo stato di connessione attuale 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 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

    boolean facoltativo

    Chrome 85 e versioni successive

    Indica se la rete è a consumo.

  • Nome

    stringa facoltativa

    Un nome della rete facile da usare.

  • NameServersConfigType

    IPConfigType facoltativo

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

  • Priorità

    number optional

    La priorità della rete.

  • ProxySettings

    ProxySettings facoltativo

    Le impostazioni del proxy della rete.

  • RestrictedConnectivity

    boolean facoltativo

    Per una rete connessa, indica 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 di applicare la configurazione IP statico.

  • 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 dell'estensione, quindi dobbiamo utilizzare una stringa per "Source" anziché un enum SourceType.

  • StaticIPConfig

    IPConfigProperties facoltativo

    La configurazione IP statico della rete.

  • TrafficCounterResetTime

    number optional

    Chrome 125 e versioni successive

    Data e ora dell'ultimo azzeramento dei contatori del 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"

"Rete dati"

"Ethernet"

"Tether"

"VPN"

"Wireless"

"WiFi"

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 del proxy manuali.

  • Manuale

    ManualProxySettings facoltativo

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

  • PAC

    stringa facoltativa

    URL del file di configurazione automatica del proxy.

  • Il tipo di impostazioni del proxy.

ProxySettingsType

Enum

"Direct"

"Manuale"

"PAC"

"WPAD"

SIMLockStatus

Proprietà

  • LockEnabled

    booleano

    Se il blocco SIM è attivo.

  • LockType

    stringa

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

  • RetriesLeft

    number optional

    Numero di tentativi di blocco con PIN consentiti prima che venga richiesto 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

    boolean facoltativo

    Indica se la rete VPN deve essere connessa automaticamente.

  • Host

    stringa facoltativa

    L'host VPN.

  • Tipo

    stringa facoltativa

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

VPNStateProperties

Proprietà

WiFiProperties

Proprietà

  • AllowGatewayARPPolling

    boolean facoltativo

    Ritirato da Chrome 131

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

  • AutoConnect

    boolean 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 reti WEP-8021X e WPA-EAP.

  • Frequenza

    number optional

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

  • FrequencyList

    number[] facoltativo

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

  • HexSSID

    stringa facoltativa

    Copia con codifica HEX dell'SSID della rete.

  • HiddenSSID

    boolean 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 solo impostata. Le proprietà restituite da getProperties non conterranno questo valore.

  • RoamThreshold

    number optional

    Ritirato, ignorato.

  • SSID

    stringa facoltativa

    L'SSID della rete.

  • Sicurezza

    stringa facoltativa

    Il tipo di sicurezza di rete.

  • SignalStrength

    number optional

    L'intensità del segnale di rete.

WiFiStateProperties

Proprietà

WiMAXProperties

Proprietà

  • AutoConnect

    boolean facoltativo

    Indica se la rete deve essere connessa automaticamente.

  • EAP

    EAPProperties facoltativo

    Le proprietà EAP della rete.

Metodi

createNetwork()

Promise 
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.* Se chiamato dalle app, false è l'unico valore consentito.

  • Le proprietà con cui configurare la nuova rete.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: string) => void

    • risultato

      stringa

Resi

  • Promise<string>

    Chrome 125 e versioni successive

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

disableNetworkType()

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

Disattiva tutti i dispositivi corrispondenti al tipo di rete specificato. Consulta la nota per enableNetworkType.

Parametri

  • networkType

    NetworkType

    Il tipo di rete da disattivare.

enableNetworkType()

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

Attiva 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()

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

Elimina 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 eliminare le configurazioni di rete condivise.

Parametri

  • networkGuid

    stringa

    Il GUID della rete da eliminare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

getCaptivePortalStatus()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: CaptivePortalStatus) => void

Resi

  • Chrome 125 e versioni successive

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

getDeviceStates()

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

Restituisce gli stati dei dispositivi di rete disponibili.

Parametri

Resi

  • Chrome 125 e versioni successive

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

getGlobalPolicy()

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

Recupera le proprietà della policy globale. Non è previsto che queste proprietà cambino durante una sessione.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: GlobalPolicy) => void

Resi

  • Promise<GlobalPolicy>

    Chrome 125 e versioni successive

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

getManagedProperties()

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

Recupera le proprietà unite della rete con ID networkGuid dalle origini: impostazioni utente, impostazioni di condivisione, policy per gli utenti, policy per i dispositivi e impostazioni attualmente attive.

Parametri

  • networkGuid

    stringa

    Il GUID della rete di cui recuperare le proprietà.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: ManagedProperties) => void

Resi

  • Chrome 125 e versioni successive

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

getNetworks()

Promise 
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 loro priorità, con le reti connesse o in fase di connessione elencate per prime.

Parametri

Resi

  • Chrome 125 e versioni successive

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

getProperties()

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

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

Parametri

  • networkGuid

    stringa

    Il GUID della rete di cui recuperare le proprietà.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkProperties) => void

Resi

  • Chrome 125 e versioni successive

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

getState()

Promise 
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 superiori rispetto a getProperties, che richiede un round trip per eseguire una query sul sottosistema di networking. 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 di cui recuperare le proprietà.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (result: NetworkStateProperties) => void

Resi

  • Chrome 125 e versioni successive

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

requestNetworkScan()

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

Richiede che il sottosistema di rete esegua la scansione di nuove reti e aggiorni l'elenco restituito da getVisibleNetworks. Si tratta solo di una richiesta: il sottosistema di rete può scegliere di ignorarla. Se l'elenco viene aggiornato, verrà attivato l'evento onNetworkListChanged.

Parametri

  • networkType

    NetworkType facoltativo

    Chrome 63 e versioni successive

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

setProperties()

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

Imposta le proprietà della rete con ID networkGuid. Questo è valido solo per le reti configurate (Origine != Nessuna). 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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

startConnect()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

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

startDisconnect()

Promise 
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 elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 125 e versioni successive

    Le promise 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,
)

Attivato quando l'elenco dei dispositivi è cambiato o sono cambiate 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 reti è 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 reti 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 quando viene completato il rilevamento di un portale per una rete. Invia il GUID della rete e lo stato del captive portal corrispondente.

Parametri