chrome.networking.onc

Descrição

A API chrome.networking.onc é usada para configurar conexões de rede (celular, Ethernet, VPN ou Wi-Fi). Essa API está disponível em sessões de quiosque do Chrome OS iniciadas automaticamente.

As configurações de conexão de rede são especificadas seguindo a especificação Open Network Configuration (ONC).

OBSERVAÇÃO: a maioria das propriedades de dicionário e dos valores de tipo enumerado usa UpperCamelCase para corresponder à especificação do ONC em vez da convenção lowerCamelCase do JavaScript.

Permissões

networking.onc

Disponibilidade

Chrome 59 ou superior Somente ChromeOS

Tipos

ActivationStateType

Enumeração

"Ativado"

"Ativando"

"Não ativado"

"Parcialmente ativado"

CaptivePortalStatus

Enumeração

"Desconhecido"

"Off-line"

"On-line"

"Portal"

"ProxyAuthRequired"

CellularProperties

Propriedades

  • ActivationState

    ActivationStateType opcional

    Estado de ativação da conta da operadora.

  • ActivationType

    string opcional

    O tipo de ativação da rede celular.

  • AllowRoaming

    booleano opcional

    Se o roaming é permitido na rede.

  • AutoConnect

    booleano opcional

    Indica se a rede celular deve ser conectada automaticamente (quando estiver dentro do alcance).

  • Família

    string opcional

    Família de tecnologia de dispositivos móveis: CDMA ou GSM.

  • FirmwareRevision

    string opcional

    A revisão de firmware carregada no modem celular.

  • FoundNetworks

    FoundNetworkProperties[] opcional

    A lista de redes encontradas durante a verificação de rede mais recente.

  • HardwareRevision

    string opcional

    Revisão do hardware do modem celular.

  • HomeProvider

    CellularProviderProperties opcional

    Informações sobre o operador que emitiu o chip atualmente instalado no modem.

  • Fabricante

    string opcional

    Fabricante do modem celular.

  • ModelID

    string opcional

    O ID do modelo do modem celular.

  • NetworkTechnology

    string opcional

    Se o modem estiver registrado em uma rede, a tecnologia de rede em uso no momento.

  • PaymentPortal

    PaymentPortal opcional

    Portal de pagamento on-line que os usuários podem usar para se inscrever ou modificar um plano de dados móveis.

  • RoamingState

    string opcional

    O estado de roaming do modem celular na rede atual.

  • SIMLockStatus

    SIMLockStatus opcional

    O estado do bloqueio do chip para redes da família GSM.

  • SIMPresent

    booleano opcional

    Se há um chip.

  • Verificação

    booleano opcional

    Chrome 63 ou superior

    Verdadeiro quando uma verificação de rede celular está em andamento.

  • ServingOperator

    CellularProviderProperties opcional

    Informações sobre a operadora em cuja rede o modem está registrado no momento.

  • SignalStrength

    número opcional

    A intensidade atual do sinal da rede.

  • SupportNetworkScan

    booleano opcional

    Indica se a rede celular oferece suporte à verificação.

CellularProviderProperties

Propriedades

  • Código

    string

    O ID da rede celular é uma concatenação simples do MCC (Mobile Country Code) e do MNC (Mobile Network Code) da rede.

  • País

    string opcional

    O código de país de duas letras.

  • Nome

    string

    O nome do operador.

CellularStateProperties

Propriedades

CertificatePattern

Propriedades

  • EnrollmentURI

    string[] opcional

    Lista de URIs aos quais o usuário pode ser direcionado caso nenhum certificado que corresponda a esse padrão seja encontrado.

  • Emissor

    IssuerSubjectPattern opcional

    Se definido, o padrão deve ser comparado com as configurações do emissor X.509.

  • IssuerCARef

    string[] opcional

    Lista de certificados de CA do emissor de certificados. Um certificado precisa ser assinado por um deles para corresponder a esse padrão.

  • Assunto

    IssuerSubjectPattern opcional

    Se definido, será o padrão com o qual as configurações de assunto X.509 devem ser correspondidas.

ClientCertificateType

Enumeração

"Ref"

"Padrão"

ConnectionStateType

Enumeração

"Conectado"

"Conectando"

"Não conectado"

DeviceStateProperties

Propriedades

  • SIMLockStatus

    SIMLockStatus opcional

    Chrome 62 ou superior

    O status de bloqueio do chip se o tipo for "Rede celular" e o status de chippresente = "Verdadeiro".

  • SIMPresent

    booleano opcional

    Chrome 62 ou superior

    Defina como o estado presente do chip se o tipo de dispositivo for celular.

  • Verificação

    booleano opcional

    Defina se o dispositivo será ativado. Verdadeiro se o dispositivo estiver fazendo a verificação.

  • O estado atual do dispositivo.

  • O tipo de rede associado ao dispositivo (celular, Ethernet ou Wi-Fi).

DeviceStateType

Enumeração

"Não inicializado"
O dispositivo está disponível, mas não foi inicializado.

"Desativado"
O dispositivo foi inicializado, mas não foi ativado.

"Ativando"
O estado ativado foi solicitado, mas não foi concluído.

"Ativado"
O dispositivo está ativado.

"Proibido"
O dispositivo é proibido.

EAPProperties

Propriedades

  • AnonymousIdentity

    string opcional

  • ClientCertPKCS11Id

    string opcional

    Chrome 60 ou superior
  • ClientCertPattern

    CertificatePattern opcional

  • ClientCertProvisioningProfileId

    string opcional

    Chrome 93 ou versão mais recente
  • ClientCertRef

    string opcional

  • ClientCertType

    ClientCertificateType

  • Identidade

    string opcional

  • INTERNO

    string opcional

  • EXTERNO

    string opcional

    O tipo de EAP externo. Exigido pelo ONC, mas pode não ser fornecido ao traduzir do shill.

  • Senha

    string opcional

  • SaveCredentials

    booleano opcional

  • ServerCAPEMs

    string[] opcional

  • ServerCARefs

    string[] opcional

  • SubjectMatch

    ManagedDOMString opcional

    Chrome 60 ou superior
  • UseProactiveKeyCaching

    booleano opcional

  • UseSystemCAs

    booleano opcional

EthernetProperties

Propriedades

  • Autenticação

    string opcional

    A autenticação usada pela rede Ethernet. Os valores possíveis são None e 8021X.

  • AutoConnect

    booleano opcional

    Indica se a rede Ethernet deve ser conectada automaticamente.

  • EAP

    EAPProperties opcional

    Configurações de EAP da rede. Exigido para a autenticação 8021X.

EthernetStateProperties

Propriedades

FoundNetworkProperties

Propriedades

  • LongName

    string opcional

    O nome no formato longo do operador de rede.

  • NetworkId

    string

    ID da rede.

  • ShortName

    string opcional

    O nome em formato curto do operador de rede.

  • Status

    string

    Disponibilidade de rede.

  • Tecnologia

    string

    Acessar tecnologia usada pela rede.

GlobalPolicy

Propriedades

  • AllowOnlyPolicyNetworksToAutoconnect

    booleano opcional

    Se verdadeiro, apenas as redes de política poderão se conectar automaticamente. O padrão é "false".

  • AllowOnlyPolicyNetworksToConnect

    booleano opcional

    Se verdadeiro, somente redes de política poderão ser conectadas e nenhuma rede nova poderá ser adicionada ou configurada. O padrão é "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    booleano opcional

    Chrome 70 ou superior

    Se definida como verdadeira e uma rede gerenciada estiver disponível na lista de redes visíveis, somente redes de política poderão ser conectadas e nenhuma rede nova poderá ser adicionada ou configurada. O padrão é "false".

  • BlockedHexSSIDs

    string[] opcional

    Chrome 86 ou versão mais recente

    Lista de redes bloqueadas. Conexões com redes bloqueadas são proibidas. As redes podem ser desbloqueadas novamente especificando uma configuração de rede explícita. O padrão é uma lista vazia.

IPConfigProperties

Propriedades

  • ExcludedRoutes

    string[] opcional

    Chrome 76 ou versão mais recente

    Matriz de blocos de IP na notação CIDR. Consulte os detalhes em onc_spec.md.

  • Gateway

    string opcional

    Endereço do gateway usado na configuração do IP.

  • IPAddress

    string opcional

    O endereço IP de uma conexão. Pode ser um endereço IPv4 ou IPv6, dependendo do valor de Type.

  • IncludedRoutes

    string[] opcional

    Chrome 76 ou versão mais recente

    Matriz de blocos de IP na notação CIDR. Consulte os detalhes em onc_spec.md.

  • NameServers

    string[] opcional

    Matriz de endereços usados para servidores de nomes.

  • RoutingPrefix

    número opcional

    O prefixo de roteamento.

  • SearchDomains

    string[] opcional

    Chrome 76 ou versão mais recente

    Matriz de strings para resolução de nome. Consulte onc_spec.md para mais detalhes.

  • Tipo

    string opcional

    O tipo de configuração do IP. Pode ser IPv4 ou IPv6.

  • WebProxyAutoDiscoveryUrl

    string opcional

    O URL para descoberta automática do proxy WEb, conforme informado no DHCP.

IPConfigType

Enumeração

"DHCP"

"Estático"

IssuerSubjectPattern

Propriedades

  • CommonName

    string opcional

    Se definido, o valor que deve corresponder ao nome comum do assunto do certificado.

  • Localidade

    string opcional

    Se definido, o valor que deve ser comparado ao local comum do assunto do certificado.

  • Organização

    string opcional

    Se definido, o valor que deve corresponder às organizações do titular do certificado. Pelo menos uma organização precisa corresponder ao valor.

  • OrganizationalUnit

    string opcional

    Se definido, o valor que deve corresponder às unidades organizacionais do assunto do certificado. Pelo menos uma unidade organizacional precisa corresponder ao valor.

ManagedBoolean

Propriedades

  • Ativo

    booleano opcional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    booleano opcional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    booleano opcional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    booleano opcional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    booleano opcional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedCellularProperties

Propriedades

ManagedDOMString

Propriedades

  • Ativo

    string opcional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    string opcional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    string opcional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    string opcional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    string opcional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedDOMStringList

Propriedades

  • Ativo

    string[] opcional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    string[] opcional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    string[] opcional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    string[] opcional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    string[] opcional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedEthernetProperties

Propriedades

ManagedIPConfigProperties

Propriedades

ManagedIPConfigType

Propriedades

  • Ativo

    IPConfigType opcional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    IPConfigType opcional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    IPConfigType opcional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    IPConfigType opcional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    IPConfigType opcional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedLong

Propriedades

  • Ativo

    número opcional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    número opcional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    número opcional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    número opcional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    número opcional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedManualProxySettings

Propriedades

ManagedProperties

Propriedades

ManagedProxyLocation

Propriedades

ManagedProxySettings

Propriedades

ManagedProxySettingsType

Propriedades

  • Ativo

    ProxySettingsType optional

    O valor ativo usado atualmente pelo gerenciador de configuração de rede (por exemplo, shill).

  • DeviceEditable

    booleano opcional

    Se existe um DevicePolicy para a propriedade e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • DevicePolicy

    ProxySettingsType optional

    O valor da propriedade fornecido pela política do dispositivo.

  • Efetivo

    string opcional

    A fonte de onde o valor da propriedade efetiva foi determinado.

  • SharedSetting

    ProxySettingsType optional

    O valor definido para todos os usuários do dispositivo. Fornecido apenas se DeviceEditiable for true.

  • UserEditable

    booleano opcional

    Se uma UserPolicy para a propriedade existe e permite que ela seja editada (ou seja, o valor da propriedade recomendada do conjunto de políticas). O valor padrão é false.

  • UserPolicy

    ProxySettingsType optional

    O valor da propriedade fornecido pela política do usuário.

  • UserSetting

    ProxySettingsType optional

    O valor da propriedade definido pelo usuário conectado. Fornecido apenas se UserEditable for true.

ManagedThirdPartyVPNProperties

Propriedades

ManagedVPNProperties

Propriedades

ManagedWiFiProperties

Propriedades

ManualProxySettings

Propriedades

  • FTPProxy

    ProxyLocation opcional

    Configurações do proxy do FTP.

  • HTTPProxy

    ProxyLocation opcional

    Configurações do proxy HTTP.

  • MEIAS

    ProxyLocation opcional

    Configurações do proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation opcional

    Configurações do proxy HTTP seguro.

NetworkConfigProperties

Propriedades

NetworkFilter

Propriedades

  • configurado

    booleano opcional

    Se verdadeiro, inclui apenas redes configuradas (salvas). O padrão é "false".

  • limite

    número opcional

    Número máximo de redes a serem retornadas. Se não for especificado, o padrão será 1.000. Use 0 se não houver limite.

  • networkType

    NetworkType

    O tipo de redes a serem retornadas.

  • visível

    booleano opcional

    Se verdadeiro, inclui apenas redes visíveis (fisicamente conectadas ou dentro do alcance). O padrão é "false".

NetworkProperties

Propriedades

  • Rede celular

    CellularProperties opcional

    No caso de redes celulares, são as propriedades da rede celular.

  • Conectável

    booleano opcional

    Se a rede pode ser conectada.

  • ConnectionState

    ConnectionStateType optional

    O estado atual da conexão da rede.

  • ErrorState

    string opcional

    O último estado de erro de rede registrado.

  • Ethernet

    EthernetProperties opcional

    Para redes Ethernet, as propriedades da rede Ethernet.

  • GUID

    string

    O GUID da rede.

  • IPAddressConfigType

    IPConfigType opcional

    O tipo de configuração do endereço IP da rede.

  • IPConfigs

    IPConfigProperties[] opcional

    A configuração do IP da rede.

  • MacAddress

    string opcional

    O endereço MAC da rede.

  • Limitada

    booleano opcional

    Chrome 85 ou superior

    Se a rede é limitada.

  • Nome

    string opcional

    Um nome de rede fácil de usar.

  • NameServersConfigType

    IPConfigType opcional

    O tipo de configuração de IP dos servidores de nomes usados pela rede.

  • Prioridade

    número opcional

    A prioridade da rede.

  • ProxySettings

    ProxySettings opcional

    Configurações de proxy da rede.

  • RestrictedConnectivity

    booleano opcional

    Em uma rede conectada, se a conectividade de rede com a Internet é limitada, por exemplo, se a rede estiver protegida por um portal ou se a rede celular não estiver ativada.

  • SavedIPConfig

    IPConfigProperties opcional

    Configuração de IP recebida do servidor DHCP antes de aplicar a configuração de IP estático.

  • Origem

    string opcional

    Indica se e como a rede está configurada. Os valores possíveis são:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "Nenhum" entra em conflito com a geração de código de extensão, então precisamos usar uma string para "Source" em vez de um tipo enumerado de origem.

  • StaticIPConfig

    IPConfigProperties opcional

    A configuração de IP estático da rede.

  • TrafficCounterResetTime

    número opcional

    Chrome 125 ou versões mais recentes

    Quando os contadores de tráfego foram redefinidos pela última vez.

  • O tipo de rede.

  • VPN

    VPNProperties opcional

    Para redes VPN, são as propriedades da VPN de rede.

  • Wi-Fi

    WiFiProperties opcional

    Para redes Wi-Fi, as propriedades da rede Wi-Fi.

NetworkStateProperties

Propriedades

NetworkType

Enumeração

"Todos"

"Celular"

"Ethernet"

"Vincular"

"VPN"

"Sem fio"

"Wi-Fi"

PaymentPortal

Propriedades

  • Método

    string

    O método HTTP a ser usado no portal de pagamentos.

  • PostData

    string opcional

    Os dados de postagem a serem enviados para o portal de pagamentos. Ignorado a menos que Method seja POST.

  • URL

    string opcional

    O URL do portal de pagamentos.

ProxyLocation

Propriedades

  • Host

    string

    O host do endereço IP do proxy.

  • Porta

    number

    A porta a ser usada para o proxy.

ProxySettings

Propriedades

  • ExcludeDomains

    string[] opcional

    São os domínios e hosts em que as configurações manuais de proxy são excluídas.

  • Manual

    ManualProxySettings opcional

    Configurações de proxy manuais: usadas apenas para configurações de proxy do Manual.

  • PAC (Comitê de Ação Política)

    string opcional

    URL do arquivo de configuração automática do proxy.

  • O tipo de configurações de proxy.

ProxySettingsType

Enumeração

"Direto"

"Manual"

"PAC"

"WPAD"

SIMLockStatus

Propriedades

  • LockEnabled

    booleano

    Indica se o bloqueio do chip está ativado.

  • LockType

    string

    O status de bloqueio do chip. Os valores possíveis são 'sim-pin', 'sim-puk' e ''.

  • RetriesLeft

    número opcional

    Número de tentativas de bloqueio por PIN permitidas antes que a PUK seja necessária para desbloquear o chip.

ThirdPartyVPNProperties

Propriedades

  • ExtensionID

    string

    ID da extensão de provedor de VPN de terceiros.

  • ProviderName

    string opcional

    O nome do provedor de VPN.

VPNProperties

Propriedades

  • AutoConnect

    booleano opcional

    Se a rede VPN deve ser conectada automaticamente.

  • Host

    string opcional

    O host da VPN.

  • Tipo

    string opcional

    O tipo de VPN. Isso não pode ser um tipo enumerado devido a "L2TP-IPSec". É opcional para NetworkConfigProperties transmitido para setProperties que pode ser usado para definir apenas propriedades específicas.

VPNStateProperties

Propriedades

WiFiProperties

Propriedades

  • AllowGatewayARPPolling

    booleano opcional

    Se a pesquisa ARP do gateway padrão é permitida. O padrão é verdadeiro (true).

  • AutoConnect

    booleano opcional

    Indica se a rede Wi-Fi deve ser conectada automaticamente quando estiver dentro do alcance.

  • BSSID

    string opcional

    O BSSID do ponto de acesso associado.

  • EAP

    EAPProperties opcional

    As propriedades EAP da rede. Obrigatório para as redes WEP-8021X e WPA-EAP.

  • Frequência

    número opcional

    A frequência de operação do serviço Wi-Fi em MHz. Para redes conectadas, a frequência atual com que a rede está conectada. Caso contrário, a frequência do melhor BSS disponível.

  • FrequencyList

    number[] opcional

    Contém toda a frequência operacional vista recentemente para a rede Wi-Fi.

  • HexSSID

    string opcional

    Cópia codificada em HEX do SSID da rede.

  • HiddenSSID

    booleano opcional

    Indica se o SSID da rede será transmitido.

  • Senha

    string opcional

    Chrome 66 ou superior

    A senha longa para conexões WEP/WPA/WPA2. Essa propriedade só pode ser definida. As propriedades retornadas por getProperties não conterão esse valor.

  • RoamThreshold

    número opcional

    Obsoleto, ignorado.

  • SSID

    string opcional

    O SSID da rede.

  • Segurança

    string opcional

    O tipo de segurança da rede.

  • SignalStrength

    número opcional

    A intensidade do sinal da rede.

WiFiStateProperties

Propriedades

WiMAXProperties

Propriedades

  • AutoConnect

    booleano opcional

    Indica se a rede deve ser conectada automaticamente.

  • EAP

    EAPProperties opcional

    As propriedades EAP da rede.

Métodos

createNetwork()

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

Cria uma nova configuração de rede a partir de propriedades. Se já houver uma rede configurada correspondente, isso vai falhar. Caso contrário, retorna o GUID da nova rede.

Parâmetros

  • compartilhados

    booleano

    Se for true, compartilhe esta configuração de rede com outros usuários.

    Essa opção é exposta apenas na interface da Web do Chrome.* Quando chamado por apps, false é o único valor permitido.

  • As propriedades com que configurar a nova rede.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: string) => void

    • resultado

      string

Retorna

  • Promessa<string>

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

disableNetworkType()

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

Desativa todos os dispositivos que correspondem ao tipo de rede especificado. Consulte a observação sobre enableNetworkType.

Parâmetros

  • networkType

    NetworkType

    O tipo de rede a ser desativada.

enableNetworkType()

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

Ativa todos os dispositivos que correspondem ao tipo de rede especificado. O tipo pode representar vários tipos de rede (por exemplo, "Sem fio").

Parâmetros

  • networkType

    NetworkType

    O tipo de rede a ser ativada.

forgetNetwork()

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

Esquece uma configuração de rede limpando todas as propriedades configuradas para a rede com o GUID networkGuid. Isso também pode incluir outras redes com identificadores correspondentes (por exemplo, SSID de Wi-Fi e Segurança). Se essa configuração não existir, será definido um erro e a operação falhará.

Nas sessões de quiosque, esse método não poderá esquecer as configurações de rede compartilhadas.

Parâmetros

  • networkGuid

    string

    O GUID da rede a ser esquecido.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getCaptivePortalStatus()

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

Retorna o status do portal cativo para a rede correspondente a "networkGuid".

Parâmetros

  • networkGuid

    string

    O GUID da rede que receberá o status do portal cativo.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: CaptivePortalStatus) => void

Retorna

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getDeviceStates()

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

Retorna os estados dos dispositivos de rede disponíveis.

Parâmetros

Retorna

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getGlobalPolicy()

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

Recebe as propriedades da política global. Não é esperado que essas propriedades mudem durante uma sessão.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: GlobalPolicy) => void

Retorna

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getManagedProperties()

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

Recupera as propriedades mescladas da rede com o ID networkGuid das origens: configurações do usuário, configurações compartilhadas, política do usuário, política do dispositivo e configurações ativas no momento.

Parâmetros

  • networkGuid

    string

    O GUID da rede para a qual as propriedades serão recebidas.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: ManagedProperties) => void

Retorna

  • Promise&lt;ManagedProperties&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getNetworks()

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

Retorna uma lista de objetos de rede com as mesmas propriedades fornecidas por getState. Um filtro é fornecido para especificar o tipo de redes retornadas e limitar o número de redes. As redes são ordenadas pelo sistema com base na prioridade, e as conectadas ou conectadas aparecem primeiro.

Parâmetros

Retorna

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getProperties()

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

Recupera todas as propriedades da rede com o ID networkGuid. Inclui todas as propriedades da rede (valores somente leitura e de leitura/gravação).

Parâmetros

  • networkGuid

    string

    O GUID da rede para a qual as propriedades serão recebidas.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: NetworkProperties) => void

Retorna

  • Promise&lt;NetworkProperties&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getState()

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

Recupera as propriedades somente leitura armazenadas em cache da rede com o ID networkGuid. Essa é uma função de desempenho mais alta do que getProperties, que requer uma ida e volta para consultar o subsistema de rede. As seguintes propriedades são retornadas para todas as redes: GUID, Type, Name, WiFi.Security. Outras propriedades são fornecidas para redes visíveis: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parâmetros

  • networkGuid

    string

    O GUID da rede para a qual as propriedades serão recebidas.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (result: NetworkStateProperties) => void

Retorna

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

requestNetworkScan()

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

Solicitações que o subsistema de rede verifica em busca de novas redes e atualiza a lista retornada por getVisibleNetworks. Isso é apenas uma solicitação: o subsistema de rede pode optar por ignorá-la. Se a lista for atualizada, o evento onNetworkListChanged será disparado.

Parâmetros

  • networkType

    NetworkType opcional

    Chrome 63 ou superior

    Se fornecido, solicita uma verificação específica para o tipo. Para dispositivos móveis, será solicitada uma verificação de rede móvel, se compatível.

setProperties()

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

Define as propriedades da rede com o ID networkGuid. Isso só é válido para redes configuradas (Origem != Nenhuma). Redes visíveis não configuradas precisam usar createNetwork. Nas sessões de quiosque, chamar esse método em uma rede compartilhada falhará.

Parâmetros

  • networkGuid

    string

    O GUID da rede para a qual as propriedades serão definidas.

  • As propriedades a serem definidas.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

startConnect()

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

Inicia uma conexão com a rede com networkGuid.

Parâmetros

  • networkGuid

    string

    O GUID da rede a ser conectada.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

startDisconnect()

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

Inicia uma desconexão da rede com networkGuid.

Parâmetros

  • networkGuid

    string

    O GUID da rede a ser desconectada.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 125 ou versões mais recentes

    As promessas só têm suporte no Manifesto V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onDeviceStateListChanged

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

Disparado quando a lista de dispositivos é alterada ou qualquer propriedade de estado do dispositivo é alterada.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    () => void

onNetworkListChanged

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

Disparado quando a lista de redes é alterada. Envia uma lista completa de GUIDs para todas as redes atuais.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (changes: string[]) => void

    • muda

      string[]

onNetworksChanged

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

Disparado quando as propriedades são alteradas em qualquer uma das redes. Envia uma lista de GUIDs para redes com propriedades que foram alteradas.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (changes: string[]) => void

    • muda

      string[]

onPortalDetectionCompleted

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

Disparado quando uma detecção de portal de uma rede é concluída. Envia o GUID da rede e o status correspondente do portal cativo.

Parâmetros