chrome.networking.onc

Descripción

La API de chrome.networking.onc se usa para configurar conexiones de red (móvil, Ethernet, VPN o Wi-Fi). Esta API está disponible en las sesiones de kiosco de ChromeOS que se inician automáticamente.

Los parámetros de configuración de conexión de red se especifican según la especificación de Open Network Configuration (ONC).

NOTA: La mayoría de las propiedades de diccionario y los valores de enumeración usan UpperCamelCase para coincidir con la especificación de ONC en lugar de la convención lowerCamelCase de JavaScript.

Permisos

networking.onc

Disponibilidad

Chrome 59 y versiones posteriores Solo en ChromeOS

Tipos

ActivationStateType

Enum

“Activado”

“Activando”

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Unknown"

"Sin conexión"

"En línea"

"Portal"

"ProxyAuthRequired"

CellularProperties

Propiedades

  • ActivationState

    ActivationStateType opcional

    Es el estado de activación de la cuenta del operador.

  • ActivationType

    cadena opcional

    Es el tipo de activación de la red celular.

  • AllowRoaming

    booleano opcional

    Indica si se permite la itinerancia en la red.

  • AutoConnect

    booleano opcional

    Indica si la red celular debe conectarse automáticamente (cuando esté dentro del alcance).

  • Familiar

    cadena opcional

    Familia de tecnología del dispositivo celular: CDMA o GSM.

  • FirmwareRevision

    cadena opcional

    Es la revisión del firmware cargada en el módem celular.

  • FoundNetworks

    FoundNetworkProperties[] opcional

    Es la lista de redes que se encontraron durante la búsqueda de redes más reciente.

  • HardwareRevision

    cadena opcional

    Es la revisión de hardware del módem celular.

  • HomeProvider

    CellularProviderProperties opcional

    Es la información sobre el operador que emitió la tarjeta SIM que está instalada en el módem.

  • Fabricante

    cadena opcional

    Es el fabricante del módem celular.

  • ModelID

    cadena opcional

    Es el ID del modelo del módem celular.

  • NetworkTechnology

    cadena opcional

    Si el módem está registrado en una red, la tecnología de red que se usa actualmente.

  • PaymentPortal

    PaymentPortal opcional

    Es un portal de pagos en línea que un usuario puede usar para registrarse en un plan de datos móviles o modificarlo.

  • RoamingState

    cadena opcional

    Es el estado de roaming del módem celular en la red actual.

  • SIMLockStatus

    SIMLockStatus opcional

    Es el estado del bloqueo de SIM para las redes de la familia GSM.

  • SIMPresent

    booleano opcional

    Indica si hay una tarjeta SIM presente.

  • Análisis

    booleano opcional

    Chrome 63 y versiones posteriores

    Es verdadero cuando se está realizando un análisis de red celular.

  • ServingOperator

    CellularProviderProperties opcional

    Es la información sobre el operador en cuya red está registrado actualmente el módem.

  • SignalStrength

    número opcional

    Es la intensidad de la señal de red actual.

  • SupportNetworkScan

    booleano opcional

    Indica si la red celular admite el análisis.

CellularProviderProperties

Propiedades

  • Código

    string

    ID de la red celular como una concatenación simple del MCC (código móvil de país) y el MNC (código de red móvil) de la red.

  • País

    cadena opcional

    Es el código de país de dos letras.

  • Nombre

    string

    Es el nombre del operador.

CellularStateProperties

Propiedades

CertificatePattern

Propiedades

  • EnrollmentURI

    string[] opcional

    Es la lista de URIs a las que se puede dirigir al usuario en caso de que no se encuentren certificados que coincidan con este patrón.

  • Emisor

    IssuerSubjectPattern opcional

    Si se configura, es el patrón con el que se debe comparar la configuración de la entidad emisora de X.509.

  • IssuerCARef

    string[] opcional

    Es la lista de certificados de CA de la entidad emisora de certificados. Para que un certificado coincida con este patrón, debe estar firmado por una de ellas.

  • Asunto

    IssuerSubjectPattern opcional

    Si se configura, es el patrón con el que se deben comparar los parámetros de configuración del sujeto X.509.

ClientCertificateType

Enum

"Ref"

"Patrón"

ConnectionStateType

Enum

"Conectado"

“Conectando”

"NotConnected"

DeviceStateProperties

Propiedades

  • SIMLockStatus

    SIMLockStatus opcional

    Chrome 62 y versiones posteriores

    Es el estado de bloqueo de la SIM si Type = Cellular y SIMPresent = True.

  • SIMPresent

    booleano opcional

    Chrome 62 y versiones posteriores

    Se establece en el estado de SIM presente si el tipo de dispositivo es celular.

  • Análisis

    booleano opcional

    Establece si el dispositivo está habilitado. Es verdadero si el dispositivo está realizando un análisis.

  • Es el estado actual del dispositivo.

  • Es el tipo de red asociado al dispositivo (móvil, Ethernet o Wi-Fi).

DeviceStateType

Enum

"Sin inicializar"
El dispositivo está disponible, pero no se inicializó.

"Inhabilitado"
El dispositivo se inicializó, pero no se habilitó.

"Habilitando":
Se solicitó el estado habilitado, pero no se completó.

"Habilitado"
El dispositivo está habilitado.

"Prohibido"
El dispositivo está prohibido.

EAPProperties

Propiedades

  • AnonymousIdentity

    cadena opcional

  • ClientCertPKCS11Id

    cadena opcional

    Chrome 60 y versiones posteriores
  • ClientCertPattern

    CertificatePattern opcional

  • ClientCertProvisioningProfileId

    cadena opcional

    Chrome 93 y versiones posteriores
  • ClientCertRef

    cadena opcional

  • ClientCertType

    ClientCertificateType

  • Identidad

    cadena opcional

  • Interna

    cadena opcional

  • Externa

    cadena opcional

    Es el tipo de EAP externo. Lo requiere la ONC, pero es posible que no se proporcione cuando se traduce desde Shill.

  • Contraseña

    cadena opcional

  • SaveCredentials

    booleano opcional

  • ServerCAPEMs

    string[] opcional

  • ServerCARefs

    string[] opcional

  • SubjectMatch

    ManagedDOMString opcional

    Chrome 60 y versiones posteriores
  • UseProactiveKeyCaching

    booleano opcional

  • UseSystemCAs

    booleano opcional

EthernetProperties

Propiedades

  • Autenticación

    cadena opcional

    Es la autenticación que usa la red Ethernet. Los valores posibles son None y 8021X.

  • AutoConnect

    booleano opcional

    Indica si la red Ethernet debe conectarse automáticamente.

  • EAP

    EAPProperties opcional

    Es la configuración del EAP de la red. Se requiere para la autenticación 802.1X.

EthernetStateProperties

Propiedades

FoundNetworkProperties

Propiedades

  • LongName

    cadena opcional

    Es el nombre del operador de red en formato largo.

  • NetworkId

    string

    Es el ID de la red.

  • ShortName

    cadena opcional

    Es el nombre abreviado del operador de red.

  • Estado

    string

    Disponibilidad de la red

  • Tecnología

    string

    Es la tecnología de acceso que usa la red.

GlobalPolicy

Propiedades

  • AllowOnlyPolicyNetworksToAutoconnect

    booleano opcional

    Si es verdadero, solo las redes de políticas pueden conectarse automáticamente. La configuración predeterminada es "false".

  • AllowOnlyPolicyNetworksToConnect

    booleano opcional

    Si es verdadero, solo se pueden conectar redes de políticas y no se pueden agregar ni configurar redes nuevas. La configuración predeterminada es "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    booleano opcional

    Chrome 70 y versiones posteriores

    Si es verdadero y hay una red administrada disponible en la lista de redes visibles, solo se pueden conectar redes de políticas y no se pueden agregar ni configurar redes nuevas. La configuración predeterminada es "false".

  • BlockedHexSSIDs

    string[] opcional

    Chrome 86 y versiones posteriores

    Es la lista de redes bloqueadas. Se prohíben las conexiones a redes bloqueadas. Las redes se pueden volver a desbloquear si se especifica una configuración de red explícita. La configuración predeterminada es una lista vacía.

IPConfigProperties

Propiedades

  • ExcludedRoutes

    string[] opcional

    Chrome 76 y versiones posteriores

    Es un array de bloques de IP en notación CIDR. Consulta onc_spec.md para obtener más detalles.

  • Puerta de enlace

    cadena opcional

    Es la dirección de la puerta de enlace que se usa para la configuración de IP.

  • IPAddress

    cadena opcional

    Es la dirección IP de una conexión. Puede ser una dirección IPv4 o IPv6, según el valor de Type.

  • IncludedRoutes

    string[] opcional

    Chrome 76 y versiones posteriores

    Es un array de bloques de IP en notación CIDR. Consulta onc_spec.md para obtener más detalles.

  • NameServers

    string[] opcional

    Es un array de direcciones que se usan para los servidores de nombres.

  • RoutingPrefix

    número opcional

    Es el prefijo de enrutamiento.

  • SearchDomains

    string[] opcional

    Chrome 76 y versiones posteriores

    Es un array de cadenas para la resolución de nombres. Consulta onc_spec.md para obtener más detalles.

  • Tipo

    cadena opcional

    Es el tipo de configuración de IP. Puede ser IPv4 o IPv6.

  • WebProxyAutoDiscoveryUrl

    cadena opcional

    Es la URL para la detección automática de proxy web, según se informa a través de DHCP.

IPConfigType

Enum

"DHCP"

"Static"

IssuerSubjectPattern

Propiedades

  • CommonName

    cadena opcional

    Si se configura, es el valor con el que se comparará el nombre común del sujeto del certificado.

  • Localidad

    cadena opcional

    Si se configura, es el valor con el que se debe comparar la ubicación común del sujeto del certificado.

  • Organización

    cadena opcional

    Si se configura, es el valor con el que se comparan las organizaciones del sujeto del certificado. Al menos una organización debe coincidir con el valor.

  • OrganizationalUnit

    cadena opcional

    Si se configura, es el valor con el que se comparan las unidades organizacionales del sujeto del certificado. Al menos una unidad organizacional debe coincidir con el valor.

ManagedBoolean

Propiedades

  • Activo

    booleano opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    booleano opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    booleano opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    booleano opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    booleano opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedCellularProperties

Propiedades

ManagedDOMString

Propiedades

  • Activo

    cadena opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    cadena opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    cadena opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    cadena opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    cadena opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedDOMStringList

Propiedades

  • Activo

    string[] opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    string[] opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    string[] opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    string[] opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    string[] opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedEthernetProperties

Propiedades

ManagedIPConfigProperties

Propiedades

ManagedIPConfigType

Propiedades

  • Activo

    IPConfigType opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    IPConfigType opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    IPConfigType opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    IPConfigType opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    IPConfigType opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedLong

Propiedades

  • Activo

    número opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    número opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    número opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    número opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    número opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedManualProxySettings

Propiedades

ManagedProperties

Propiedades

ManagedProxyLocation

Propiedades

ManagedProxySettings

Propiedades

ManagedProxySettingsType

Propiedades

  • Activo

    ProxySettingsType opcional

    Es el valor activo que usa actualmente el administrador de configuración de red (p.ej., Shill).

  • DeviceEditable

    booleano opcional

    Indica si existe una DevicePolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • DevicePolicy

    ProxySettingsType opcional

    Es el valor de la propiedad que proporciona la política de dispositivo.

  • Entrada en vigencia:

    cadena opcional

    Es la fuente a partir de la cual se determinó el valor de la propiedad efectiva.

  • SharedSetting

    ProxySettingsType opcional

    Es el valor establecido para todos los usuarios del dispositivo. Solo se proporciona si DeviceEditiable es true.

  • UserEditable

    booleano opcional

    Indica si existe una UserPolicy para la propiedad y si permite editarla (es decir, el valor de propiedad recomendado establecido por la política). La configuración predeterminada es false.

  • UserPolicy

    ProxySettingsType opcional

    Es el valor de la propiedad que proporciona la política del usuario.

  • UserSetting

    ProxySettingsType opcional

    Es el valor de la propiedad establecido por el usuario que accedió. Solo se proporciona si UserEditable es true.

ManagedThirdPartyVPNProperties

Propiedades

ManagedVPNProperties

Propiedades

ManagedWiFiProperties

Propiedades

ManualProxySettings

Propiedades

  • FTPProxy

    ProxyLocation opcional

    Es la configuración del proxy FTP.

  • HTTPProxy

    ProxyLocation opcional

    Es la configuración del proxy HTTP.

  • CALCETINES

    ProxyLocation opcional

    Es la configuración del proxy de SOCKS.

  • SecureHTTPProxy

    ProxyLocation opcional

    Es la configuración del proxy HTTP seguro.

NetworkConfigProperties

Propiedades

NetworkFilter

Propiedades

  • configurados

    booleano opcional

    Si es verdadero, solo se incluyen las redes configuradas (guardadas). La configuración predeterminada es “false”.

  • límite

    número opcional

    Cantidad máxima de redes que se devolverán. Si no se especifica, el valor predeterminado es 1,000. Usa 0 para no establecer un límite.

  • networkType

    NetworkType

    Es el tipo de redes que se devolverán.

  • visible

    booleano opcional

    Si es verdadero, solo se incluyen las redes visibles (conectadas físicamente o dentro del alcance). La configuración predeterminada es “false”.

NetworkProperties

Propiedades

  • Móvil

    CellularProperties opcional

    Para redes móviles, son las propiedades de la red móvil.

  • Conectable

    booleano opcional

    Indica si la red se puede conectar.

  • ConnectionState

    ConnectionStateType opcional

    Es el estado de conexión actual de la red.

  • ErrorState

    cadena opcional

    Es el último estado de error de red registrado.

  • Ethernet

    EthernetProperties opcional

    Son las propiedades de la red Ethernet.

  • GUID

    string

    Es el GUID de la red.

  • IPAddressConfigType

    IPConfigType opcional

    Es el tipo de configuración de la dirección IP de la red.

  • IPConfigs

    IPConfigProperties[] opcional

    Es la configuración de IP de la red.

  • MacAddress

    cadena opcional

    Es la dirección MAC de la red.

  • De uso medido

    booleano opcional

    Chrome 85 y versiones posteriores

    Indica si la red es de uso medido.

  • Nombre

    cadena opcional

    Es un nombre de red fácil de usar.

  • NameServersConfigType

    IPConfigType opcional

    Es el tipo de configuración de IP para los servidores de nombres que usa la red.

  • Prioridad

    número opcional

    Es la prioridad de la red.

  • ProxySettings

    ProxySettings opcional

    Es la configuración del proxy de la red.

  • RestrictedConnectivity

    booleano opcional

    Para una red conectada, indica si la conectividad de red a Internet es limitada, p.ej., si la red está protegida por un portal o si no se activó una red celular.

  • SavedIPConfig

    IPConfigProperties opcional

    Es la configuración de IP que se recibió del servidor DHCP antes de aplicar la configuración de IP estática.

  • Fuente

    cadena opcional

    Indica si la red está configurada y cómo. Los valores posibles son:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" entra en conflicto con la generación de código de extensión, por lo que debemos usar una cadena para "Source" en lugar de una enumeración de SourceType.

  • StaticIPConfig

    IPConfigProperties opcional

    Es la configuración de IP estática de la red.

  • TrafficCounterResetTime

    número opcional

    Chrome 125 y versiones posteriores

    Fecha y hora en que se restablecieron los contadores de tráfico por última vez.

  • Es el tipo de red.

  • VPN

    VPNProperties opcional

    Para las redes VPN, son las propiedades de la red VPN.

  • Wi-Fi

    WiFiProperties opcional

    Son las propiedades de Wi-Fi de la red, en el caso de las redes Wi-Fi.

NetworkStateProperties

Propiedades

NetworkType

Enum

"Todo"

"Celular"

"Ethernet"

"Tether"

"VPN"

"Inalámbrico"

"Wi-Fi"

PaymentPortal

Propiedades

  • Método

    string

    Es el método HTTP que se usará para el portal de pagos.

  • PostData

    cadena opcional

    Son los datos de la publicación que se enviarán al portal de pagos. Se ignorará, a menos que Method sea POST.

  • URL

    cadena opcional

    Es la URL del portal de pagos.

ProxyLocation

Propiedades

  • Host

    string

    Es el host de la dirección IP del proxy.

  • Puerto

    número

    Es el puerto que se usará para el proxy.

ProxySettings

Propiedades

  • ExcludeDomains

    string[] opcional

    Son los dominios y hosts para los que se excluye la configuración manual del proxy.

  • Manual

    ManualProxySettings opcional

    Configuración manual del proxy: Se usa solo para la configuración del proxy de Manual.

  • Comisión de acción política

    cadena opcional

    Es la URL del archivo de configuración automática del proxy.

  • Es el tipo de configuración de proxy.

ProxySettingsType

Enum

"Directo"

"Manual"

"PAC"

"WPAD"

SIMLockStatus

Propiedades

  • LockEnabled

    booleano

    Indica si el bloqueo de SIM está habilitado.

  • LockType

    string

    Es el estado del bloqueo de SIM. Los valores posibles son 'sim-pin', 'sim-puk' y ''.

  • RetriesLeft

    número opcional

    Cantidad de intentos de bloqueo con PIN permitidos antes de que se requiera el PUK para desbloquear la SIM.

ThirdPartyVPNProperties

Propiedades

  • ExtensionID

    string

    ID de la extensión del proveedor de VPN externo.

  • ProviderName

    cadena opcional

    Es el nombre del proveedor de VPN.

VPNProperties

Propiedades

  • AutoConnect

    booleano opcional

    Indica si la red VPN debe conectarse automáticamente.

  • Host

    cadena opcional

    Es el host de la VPN.

  • Tipo

    cadena opcional

    Es el tipo de VPN. No puede ser una enumeración debido a "L2TP-IPSec". Esto es opcional para NetworkConfigProperties, que se pasa a setProperties y se puede usar para establecer solo propiedades específicas.

VPNStateProperties

Propiedades

WiFiProperties

Propiedades

  • AllowGatewayARPPolling

    booleano opcional

    Obsoleto desde Chrome 131

    Se quitó en M131. No hay sondeo de ARP activo en este momento.

  • AutoConnect

    booleano opcional

    Indica si la red Wi-Fi se debe conectar automáticamente cuando esté dentro del alcance.

  • BSSID

    cadena opcional

    Es el BSSID del punto de acceso asociado.

  • EAP

    EAPProperties opcional

    Son las propiedades de EAP de la red. Se requiere para las redes WEP-8021X y WPA-EAP.

  • Frecuencia

    número opcional

    Frecuencia de funcionamiento del servicio de Wi-Fi en MHz. Para las redes conectadas, es la frecuencia actual en la que está conectada la red. De lo contrario, la frecuencia de la BSS disponible más adecuada.

  • FrequencyList

    number[] opcional

    Contiene todas las frecuencias de funcionamiento que se vieron recientemente para la red Wi-Fi.

  • HexSSID

    cadena opcional

    Copia codificada en HEX del SSID de la red.

  • HiddenSSID

    booleano opcional

    Indica si se transmitirá el SSID de la red.

  • Frase de contraseña

    cadena opcional

    Chrome 66 y versiones posteriores

    Es la frase de contraseña para las conexiones WEP, WPA y WPA2. Esta propiedad solo se puede establecer. Las propiedades que muestra getProperties no contendrán este valor.

  • RoamThreshold

    número opcional

    Obsoleto y se ignora.

  • SSID

    cadena opcional

    Es el SSID de la red.

  • Seguridad

    cadena opcional

    Es el tipo de seguridad de la red.

  • SignalStrength

    número opcional

    Es la intensidad de la señal de la red.

WiFiStateProperties

Propiedades

WiMAXProperties

Propiedades

  • AutoConnect

    booleano opcional

    Indica si la red se debe conectar automáticamente.

  • EAP

    EAPProperties opcional

    Son las propiedades de EAP de la red.

Métodos

createNetwork()

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

Crea una nueva configuración de red a partir de propiedades. Si ya existe una red configurada coincidente, esta operación fallará. De lo contrario, devuelve el GUID de la nueva red.

Parámetros

  • compartido

    booleano

    Si es true, comparte esta configuración de red con otros usuarios.

    Esta opción solo se expone a la IU web de Chrome.* Cuando las apps llaman a este método, false es el único valor permitido.

  • Son las propiedades con las que se configurará la nueva red.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: string) => void

    • resultado

      string

Muestra

  • Promise<string>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

disableNetworkType()

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

Inhabilita los dispositivos que coincidan con el tipo de red especificado. Consulta la nota para enableNetworkType.

Parámetros

  • networkType

    NetworkType

    Es el tipo de red que se inhabilitará.

enableNetworkType()

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

Habilita los dispositivos que coincidan con el tipo de red especificado. Ten en cuenta que el tipo puede representar varios tipos de red (p.ej., "Inalámbrica").

Parámetros

  • networkType

    NetworkType

    Es el tipo de red que se habilitará.

forgetNetwork()

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

Olvida una configuración de red borrando todas las propiedades configuradas para la red con el GUID networkGuid. Esto también puede incluir cualquier otra red con identificadores coincidentes (p.ej., SSID y seguridad de Wi-Fi). Si no existe tal configuración, se establecerá un error y la operación fallará.

En las sesiones de kiosco, este método no podrá olvidar los parámetros de configuración de red compartidos.

Parámetros

  • networkGuid

    string

    Es el GUID de la red que se olvidará.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getCaptivePortalStatus()

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

Devuelve el estado del portal cautivo para la red que coincide con "networkGuid".

Parámetros

  • networkGuid

    string

    Es el GUID de la red para la que se obtendrá el estado del portal cautivo.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: CaptivePortalStatus) => void

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getDeviceStates()

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

Devuelve los estados de los dispositivos de redes disponibles.

Parámetros

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getGlobalPolicy()

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

Obtiene las propiedades de la política global. No se espera que estas propiedades cambien durante una sesión.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: GlobalPolicy) => void

Muestra

  • Promise<GlobalPolicy>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getManagedProperties()

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

Obtiene las propiedades combinadas de la red con el identificador networkGuid de las siguientes fuentes: configuración del usuario, configuración compartida, política del usuario, política del dispositivo y la configuración activa actualmente.

Parámetros

  • networkGuid

    string

    Es el GUID de la red para la que se obtendrán las propiedades.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: ManagedProperties) => void

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getNetworks()

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

Devuelve una lista de objetos de red con las mismas propiedades que proporciona getState. Se proporciona un filtro para especificar el tipo de redes que se muestran y limitar la cantidad de redes. El sistema ordena las redes según su prioridad, y las redes conectadas o en proceso de conexión se muestran primero.

Parámetros

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getProperties()

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

Obtiene todas las propiedades de la red con el identificador networkGuid. Incluye todas las propiedades de la red (valores de solo lectura y de lectura/escritura).

Parámetros

  • networkGuid

    string

    Es el GUID de la red para la que se obtendrán las propiedades.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: NetworkProperties) => void

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

getState()

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

Obtiene las propiedades de solo lectura almacenadas en caché de la red con el identificador networkGuid. Esta función está diseñada para tener un mayor rendimiento que getProperties, que requiere un viaje de ida y vuelta para consultar el subsistema de redes. Se devuelven las siguientes propiedades para todas las redes: GUID, Type, Name y WiFi.Security. Se proporcionan propiedades adicionales para las redes visibles: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Parámetros

  • networkGuid

    string

    Es el GUID de la red para la que se obtendrán las propiedades.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (result: NetworkStateProperties) => void

Muestra

  • Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

requestNetworkScan()

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

Solicita que el subsistema de redes busque redes nuevas y actualice la lista que devuelve getVisibleNetworks. Esta es solo una solicitud: el subsistema de red puede optar por ignorarla. Si se actualiza la lista, se activará el evento onNetworkListChanged.

Parámetros

  • networkType

    NetworkType opcional

    Chrome 63 y versiones posteriores

    Si se proporciona, solicita un análisis específico para el tipo. En el caso de la red celular, se solicitará un análisis de la red móvil si es compatible.

setProperties()

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

Establece las propiedades de la red con el ID networkGuid. Esto solo es válido para las redes configuradas (Source != None). Las redes visibles sin configurar deben usar createNetwork en su lugar. En las sesiones de kiosco, llamar a este método en una red compartida fallará.

Parámetros

  • networkGuid

    string

    Es el GUID de la red para la que se establecerán propiedades.

  • Propiedades que se establecerán.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

startConnect()

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

Inicia una conexión a la red con networkGuid.

Parámetros

  • networkGuid

    string

    Es el GUID de la red a la que se conectará.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

startDisconnect()

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

Inicia una desconexión de la red con networkGuid.

Parámetros

  • networkGuid

    string

    Es el GUID de la red de la que se desconectará.

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    () => void

Muestra

  • Promise<void>

    Chrome 125 y versiones posteriores

    Las promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.

Eventos

onDeviceStateListChanged

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

Se activa cuando cambia la lista de dispositivos o las propiedades de estado de algún dispositivo.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    () => void

onNetworkListChanged

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

Se activa cuando cambia la lista de redes. Envía una lista completa de GUIDs para todas las redes actuales.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (changes: string[]) => void

    • Cambios

      string[]

onNetworksChanged

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

Se activa cuando cambian las propiedades de cualquiera de las redes. Envía una lista de GUIDs para las redes cuyas propiedades cambiaron.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (changes: string[]) => void

    • Cambios

      string[]

onPortalDetectionCompleted

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

Se activa cuando se completa la detección de un portal para una red. Envía el GUID de la red y el estado del portal cautivo correspondiente.

Parámetros