chrome.networking.onc

Description

L'API chrome.networking.onc permet de configurer les connexions réseau (mobile, Ethernet, VPN ou Wi-Fi). Cette API est disponible dans les sessions kiosque ChromeOS lancées automatiquement.

Les configurations de connexion réseau sont spécifiées conformément à la spécification Open Network Configuration (ONC).

REMARQUE : La plupart des propriétés de dictionnaire et des valeurs d'énumération utilisent UpperCamelCase pour correspondre à la spécification ONC au lieu de la convention JavaScript lowerCamelCase.

Autorisations

networking.onc

Disponibilité

Chrome 59 ou version ultérieure ChromeOS uniquement

Types

ActivationStateType

Énumération

"Activé"

Activation en cours

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Énumération

"Inconnu"

"Hors connexion"

"En ligne"

"Portal"

"ProxyAuthRequired"

CellularProperties

Propriétés

  • ActivationState

    ActivationStateType facultatif

    État d'activation du compte de l'opérateur.

  • ActivationType

    chaîne facultative

    Type d'activation du réseau mobile.

  • AllowRoaming

    booléen facultatif

    Indique si l'itinérance est autorisée pour le réseau.

  • AutoConnect

    booléen facultatif

    Indique si le réseau mobile doit être connecté automatiquement (lorsqu'il est à portée).

  • Famille

    chaîne facultative

    Famille de technologie de l'appareil mobile : CDMA ou GSM.

  • FirmwareRevision

    chaîne facultative

    Révision du micrologiciel chargé dans le modem cellulaire.

  • FoundNetworks

    FoundNetworkProperties[] facultatif

    Liste des réseaux trouvés lors de la dernière recherche de réseau.

  • HardwareRevision

    chaîne facultative

    Révision matérielle du modem cellulaire.

  • HomeProvider

    CellularProviderProperties facultatif

    Informations sur l'opérateur qui a émis la carte SIM actuellement installée dans le modem.

  • Fabricant

    chaîne facultative

    Fabricant du modem cellulaire.

  • ModelID

    chaîne facultative

    ID du modèle de modem cellulaire.

  • NetworkTechnology

    chaîne facultative

    Technologie réseau actuellement utilisée si le modem est enregistré sur un réseau.

  • PaymentPortal

    PaymentPortal facultatif

    Portail de paiement en ligne qu'un utilisateur peut utiliser pour s'abonner à un forfait de données mobiles ou le modifier.

  • RoamingState

    chaîne facultative

    État d'itinérance du modem mobile sur le réseau actuel.

  • SIMLockStatus

    SIMLockStatus facultatif

    État du verrouillage SIM pour les réseaux de la famille GSM.

  • SIMPresent

    booléen facultatif

    Indique si une carte SIM est présente.

  • Analyse

    booléen facultatif

    Chrome 63 et versions ultérieures

    Vrai lorsqu'une analyse du réseau mobile est en cours.

  • ServingOperator

    CellularProviderProperties facultatif

    Informations sur l'opérateur sur le réseau duquel le modem est actuellement enregistré.

  • SignalStrength

    number facultatif

    Intensité actuelle du signal réseau.

  • SupportNetworkScan

    booléen facultatif

    Indique si le réseau mobile est compatible avec l'analyse.

CellularProviderProperties

Propriétés

  • Code

    chaîne

    ID du réseau mobile sous la forme d'une simple concaténation du MCC (Mobile Country Code) et du MNC (Mobile Network Code) du réseau.

  • Pays

    chaîne facultative

    Code pays à deux lettres.

  • Nom

    chaîne

    Nom de l'opérateur.

CellularStateProperties

Propriétés

CertificatePattern

Propriétés

  • EnrollmentURI

    string[] facultatif

    Liste des URI vers lesquels l'utilisateur peut être redirigé si aucun certificat correspondant à ce modèle n'est trouvé.

  • Émetteur

    IssuerSubjectPattern facultatif

    Si cette option est définie, elle correspond au modèle auquel les paramètres de l'émetteur X.509 doivent correspondre.

  • IssuerCARef

    string[] facultatif

    Liste des certificats CA de l'émetteur de certificats. Pour correspondre à ce modèle, un certificat doit être signé par l'une d'elles.

  • Objet

    IssuerSubjectPattern facultatif

    Si cette option est définie, elle correspond au format auquel les paramètres de sujet X.509 doivent correspondre.

ClientCertificateType

Énumération

"Ref"

"Pattern"

ConnectionStateType

Énumération

"Connecté"

Connexion en cours

"NotConnected"

DeviceStateProperties

Propriétés

  • SIMLockStatus

    SIMLockStatus facultatif

    Chrome 62 et versions ultérieures

    État du blocage SIM si Type = Cellular et SIMPresent = True.

  • SIMPresent

    booléen facultatif

    Chrome 62 et versions ultérieures

    Définissez l'état de la carte SIM sur "présente" si le type d'appareil est "Cellular" (Cellulaire).

  • Analyse

    booléen facultatif

    Indique si l'appareil est activé. "True" si l'appareil est en cours de scan.

  • État actuel de l'appareil.

  • Type de réseau associé à l'appareil (réseau mobile, Ethernet ou Wi-Fi).

DeviceStateType

Énumération

"Non initialisé"
L'appareil est disponible, mais pas initialisé.

Désactivé
L'appareil est initialisé, mais pas activé.

Activation :
L'état "Activé" a été demandé, mais n'est pas encore effectif.

Activé
L'appareil est activé.

Interdit
L'appareil est interdit.

EAPProperties

Propriétés

  • AnonymousIdentity

    chaîne facultative

  • ClientCertPKCS11Id

    chaîne facultative

    Chrome 60 et versions ultérieures
  • ClientCertPattern

    CertificatePattern facultatif

  • ClientCertProvisioningProfileId

    chaîne facultative

    Chrome 93 et versions ultérieures
  • ClientCertRef

    chaîne facultative

  • ClientCertType

    ClientCertificateType

  • Identité

    chaîne facultative

  • Interne

    chaîne facultative

  • Externe

    chaîne facultative

    Type EAP externe. Requis par l'ONC, mais peut ne pas être fourni lors de la traduction à partir de Shill.

  • Mot de passe

    chaîne facultative

  • SaveCredentials

    booléen facultatif

  • ServerCAPEMs

    string[] facultatif

  • ServerCARefs

    string[] facultatif

  • SubjectMatch

    ManagedDOMString facultatif

    Chrome 60 et versions ultérieures
  • UseProactiveKeyCaching

    booléen facultatif

  • UseSystemCAs

    booléen facultatif

EthernetProperties

Propriétés

  • Authentification

    chaîne facultative

    Authentification utilisée par le réseau Ethernet. Les valeurs possibles sont None et 8021X.

  • AutoConnect

    booléen facultatif

    Indique si le réseau Ethernet doit être connecté automatiquement.

  • EAP

    EAPProperties facultatif

    Paramètres EAP du réseau. Requis pour l'authentification 802.1X.

EthernetStateProperties

Propriétés

FoundNetworkProperties

Propriétés

  • LongName

    chaîne facultative

    Nom complet de l'opérateur du réseau.

  • NetworkId

    chaîne

    ID du réseau.

  • ShortName

    chaîne facultative

    Nom abrégé de l'opérateur du réseau.

  • État

    chaîne

    Disponibilité du réseau.

  • Technologie

    chaîne

    Technologie d'accès utilisée par le réseau.

GlobalPolicy

Propriétés

  • AllowOnlyPolicyNetworksToAutoconnect

    booléen facultatif

    Si la valeur est "true", seuls les réseaux de règles peuvent se connecter automatiquement. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnect

    booléen facultatif

    Si la valeur est "true", seuls les réseaux de règles peuvent être connectés, et aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    booléen facultatif

    Chrome 70 et versions ultérieures

    Si la valeur est "true" et qu'un réseau géré est disponible dans la liste des réseaux visibles, seuls les réseaux de règles peuvent être utilisés. Aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • BlockedHexSSIDs

    string[] facultatif

    Chrome 86 et versions ultérieures

    Liste des réseaux bloqués. Les connexions aux réseaux bloqués sont interdites. Vous pouvez débloquer à nouveau les réseaux en spécifiant une configuration réseau explicite. La liste est vide par défaut.

IPConfigProperties

Propriétés

  • ExcludedRoutes

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de blocs d'adresses IP au format CIDR. Pour en savoir plus, consultez onc_spec.md.

  • Passerelle

    chaîne facultative

    Adresse de la passerelle utilisée pour la configuration IP.

  • IPAddress

    chaîne facultative

    Adresse IP d'une connexion. Il peut s'agir d'une adresse IPv4 ou IPv6, selon la valeur de Type.

  • IncludedRoutes

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de blocs d'adresses IP au format CIDR. Pour en savoir plus, consultez onc_spec.md.

  • NameServers

    string[] facultatif

    Tableau d'adresses utilisées pour les serveurs de noms.

  • RoutingPrefix

    number facultatif

    Préfixe de routage.

  • SearchDomains

    string[] facultatif

    Chrome 76 et versions ultérieures

    Tableau de chaînes pour la résolution de noms. Pour en savoir plus, consultez onc_spec.md.

  • Type

    chaîne facultative

    Type de configuration IP. Il peut s'agir de IPv4 ou IPv6.

  • WebProxyAutoDiscoveryUrl

    chaîne facultative

    URL pour la découverte automatique du proxy Web, telle qu'indiquée sur DHCP.

IPConfigType

Énumération

"DHCP"

"Static"

IssuerSubjectPattern

Propriétés

  • CommonName

    chaîne facultative

    Si elle est définie, il s'agit de la valeur à laquelle le nom commun de l'objet du certificat doit correspondre.

  • Localité

    chaîne facultative

    Si elle est définie, il s'agit de la valeur à laquelle faire correspondre l'emplacement commun de l'objet du certificat.

  • Organisation

    chaîne facultative

    Si cette option est définie, il s'agit de la valeur à laquelle comparer les organisations du sujet du certificat. Au moins une organisation doit correspondre à la valeur.

  • OrganizationalUnit

    chaîne facultative

    Si cette option est définie, il s'agit de la valeur à laquelle faire correspondre les unités organisationnelles du sujet du certificat. Au moins une unité organisationnelle doit correspondre à la valeur.

ManagedBoolean

Propriétés

  • Actif

    booléen facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    booléen facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    booléen facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    booléen facultatif

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    booléen facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedCellularProperties

Propriétés

ManagedDOMString

Propriétés

  • Actif

    chaîne facultative

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    chaîne facultative

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    chaîne facultative

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    chaîne facultative

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    chaîne facultative

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedDOMStringList

Propriétés

  • Actif

    string[] facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    string[] facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    string[] facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    string[] facultatif

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    string[] facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedEthernetProperties

Propriétés

ManagedIPConfigProperties

Propriétés

ManagedIPConfigType

Propriétés

  • Actif

    IPConfigType facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    IPConfigType facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    IPConfigType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedLong

Propriétés

  • Actif

    number facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    number facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    number facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    number facultatif

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    number facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedManualProxySettings

Propriétés

ManagedProperties

Propriétés

ManagedProxyLocation

Propriétés

ManagedProxySettings

Propriétés

ManagedProxySettingsType

Propriétés

  • Actif

    ProxySettingsType facultatif

    Valeur active actuellement utilisée par le gestionnaire de configuration réseau (par exemple, Shill).

  • DeviceEditable

    booléen facultatif

    Indique si une règle DevicePolicy existe pour la propriété et si elle permet de la modifier (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    ProxySettingsType facultatif

    Valeur de la propriété fournie par la règle relative aux appareils.

  • En vigueur

    chaîne facultative

    Source à partir de laquelle la valeur de propriété effective a été déterminée.

  • SharedSetting

    ProxySettingsType facultatif

    Valeur définie pour tous les utilisateurs de l'appareil. Fourni uniquement si DeviceEditiable est défini sur true.

  • UserEditable

    booléen facultatif

    Indique si une UserPolicy existe pour la propriété et si elle autorise la modification de la propriété (c'est-à-dire la valeur de propriété recommandée définie par la règle). La valeur par défaut est false.

  • UserPolicy

    ProxySettingsType facultatif

    Valeur de la propriété fournie par le règlement utilisateur.

  • UserSetting

    ProxySettingsType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est défini sur true.

ManagedThirdPartyVPNProperties

Propriétés

ManagedVPNProperties

Propriétés

ManagedWiFiProperties

Propriétés

ManualProxySettings

Propriétés

  • FTPProxy

    ProxyLocation facultatif

    Paramètres du proxy FTP.

  • HTTPProxy

    ProxyLocation facultatif

    Paramètres du proxy HTTP.

  • CHAUSSETTES

    ProxyLocation facultatif

    Paramètres du proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation facultatif

    Paramètres du proxy HTTP sécurisé.

NetworkConfigProperties

Propriétés

NetworkFilter

Propriétés

  • configurée

    booléen facultatif

    Si la valeur est "true", seuls les réseaux configurés (enregistrés) sont inclus. La valeur par défaut est "false".

  • limite

    number facultatif

    Nombre maximal de réseaux à renvoyer. En l'absence de spécification, la valeur par défaut est 1 000. Définissez cette valeur sur 0 pour ne pas appliquer de limite.

  • networkType

    Type de réseau

    Type de réseaux à renvoyer.

  • visible

    booléen facultatif

    Si la valeur est "true", seuls les réseaux visibles (physiquement connectés ou à portée) sont inclus. La valeur par défaut est "false".

NetworkProperties

Propriétés

  • Connexion cellulaire

    CellularProperties facultatif

    Pour les réseaux mobiles, propriétés du réseau mobile.

  • Connectable

    booléen facultatif

    Indique si le réseau est connectable.

  • ConnectionState

    ConnectionStateType facultatif

    État actuel de la connexion réseau.

  • ErrorState

    chaîne facultative

    Dernier état d'erreur réseau enregistré.

  • Ethernet

    EthernetProperties facultatif

    Pour les réseaux Ethernet, les propriétés du réseau Ethernet.

  • GUID

    chaîne

    GUID du réseau.

  • IPAddressConfigType

    IPConfigType facultatif

    Type de configuration d'adresse IP du réseau.

  • IPConfigs

    IPConfigProperties[] facultatif

    Configuration IP du réseau.

  • MacAddress

    chaîne facultative

    Adresse MAC du réseau.

  • Facturé à l'usage

    booléen facultatif

    Chrome 85 ou version ultérieure

    Indique si le réseau est facturé à l'usage.

  • Nom

    chaîne facultative

    Nom convivial du réseau.

  • NameServersConfigType

    IPConfigType facultatif

    Type de configuration IP pour les serveurs de noms utilisés par le réseau.

  • Priorité

    number facultatif

    Priorité du réseau.

  • ProxySettings

    ProxySettings facultatif

    Paramètres proxy du réseau.

  • RestrictedConnectivity

    booléen facultatif

    Pour un réseau connecté, indique si la connectivité réseau à Internet est limitée (par exemple, si le réseau se trouve derrière un portail ou si un réseau mobile n'est pas activé).

  • SavedIPConfig

    IPConfigProperties facultatif

    Configuration IP reçue du serveur DHCP avant l'application de la configuration IP statique.

  • Source

    chaîne facultative

    Indique si et comment le réseau est configuré. Les valeurs possibles sont :

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" est en conflit avec la génération de code d'extension. Nous devons donc utiliser une chaîne pour "Source" au lieu d'un enum SourceType.

  • StaticIPConfig

    IPConfigProperties facultatif

    Configuration de l'adresse IP statique du réseau.

  • TrafficCounterResetTime

    number facultatif

    Chrome 125 et versions ultérieures

    Date de la dernière réinitialisation des compteurs de trafic.

  • Type de réseau.

  • VPN

    VPNProperties facultatif

    Pour les réseaux VPN, les propriétés VPN du réseau.

  • Wi-Fi

    WiFiProperties facultatif

    Pour les réseaux Wi-Fi, les propriétés Wi-Fi du réseau.

NetworkStateProperties

Propriétés

NetworkType

Énumération

Tous

Données mobiles

"Ethernet"

"Tether"

"VPN"

Sans fil

"WiFi"

PaymentPortal

Propriétés

  • Méthode

    chaîne

    Méthode HTTP à utiliser pour le portail de paiement.

  • PostData

    chaîne facultative

    Données POST à envoyer au portail de paiement. Ignoré, sauf si Method est POST.

  • URL

    chaîne facultative

    URL du portail de paiement.

ProxyLocation

Propriétés

  • Hôte

    chaîne

    Hôte de l'adresse IP du proxy.

  • Port

    Total

    Port à utiliser pour le proxy.

ProxySettings

Propriétés

  • ExcludeDomains

    string[] facultatif

    Domaines et hôtes pour lesquels les paramètres de proxy manuels sont exclus.

  • Manuel

    ManualProxySettings facultatif

    Paramètres de proxy manuels : utilisés uniquement pour les paramètres de proxy Manual.

  • PAC

    chaîne facultative

    URL du fichier de configuration automatique du proxy.

  • Type de paramètres de proxy.

ProxySettingsType

Énumération

"Direct"

Manuel

"PAC"

"WPAD"

SIMLockStatus

Propriétés

  • LockEnabled

    booléen

    Indique si le verrouillage de la carte SIM est activé.

  • LockType

    chaîne

    État du verrouillage SIM : les valeurs possibles sont 'sim-pin', 'sim-puk' et ''.

  • RetriesLeft

    number facultatif

    Nombre de tentatives de saisie du code PIN autorisées avant que la clé PUK ne soit requise pour déverrouiller la carte SIM.

ThirdPartyVPNProperties

Propriétés

  • ExtensionID

    chaîne

    ID de l'extension du fournisseur de VPN tiers.

  • ProviderName

    chaîne facultative

    Nom du fournisseur de VPN.

VPNProperties

Propriétés

  • AutoConnect

    booléen facultatif

    Indique si le réseau VPN doit être connecté automatiquement.

  • Hôte

    chaîne facultative

    Hôte VPN.

  • Type

    chaîne facultative

    Type de VPN. Il ne peut pas s'agir d'une énumération en raison de "L2TP-IPSec". Ce paramètre est facultatif pour NetworkConfigProperties, qui est transmis à setProperties et peut être utilisé pour définir uniquement des propriétés spécifiques.

VPNStateProperties

Propriétés

WiFiProperties

Propriétés

  • AllowGatewayARPPolling

    booléen facultatif

    Obsolète depuis Chrome 131

    Supprimée dans M131. Aucune interrogation ARP active n'est en cours.

  • AutoConnect

    booléen facultatif

    Indique si le réseau Wi-Fi doit être connecté automatiquement lorsqu'il est à portée.

  • BSSID

    chaîne facultative

    BSSID du point d'accès associé.

  • EAP

    EAPProperties facultatif

    Propriétés EAP du réseau. Obligatoire pour les réseaux WEP-8021X et WPA-EAP.

  • Fréquence

    number facultatif

    Fréquence de fonctionnement du service Wi-Fi en MHz. Pour les réseaux connectés, il s'agit de la fréquence actuelle à laquelle le réseau est connecté. Sinon, la fréquence du meilleur BSS disponible.

  • FrequencyList

    number[] facultatif

    Contient toutes les fréquences de fonctionnement récemment observées pour le réseau Wi-Fi.

  • HexSSID

    chaîne facultative

    Copie encodée en HEX du SSID du réseau.

  • HiddenSSID

    booléen facultatif

    Indique si le SSID du réseau sera diffusé.

  • Phrase secrète

    chaîne facultative

    Chrome 66 et versions ultérieures

    Phrase secrète pour les connexions WEP/WPA/WPA2. Cette propriété ne peut être définie. Les propriétés renvoyées par getProperties ne contiendront pas cette valeur.

  • RoamThreshold

    number facultatif

    Obsolète, ignoré.

  • SSID

    chaîne facultative

    SSID du réseau.

  • Sécurité

    chaîne facultative

    Type de sécurité du réseau.

  • SignalStrength

    number facultatif

    Intensité du signal du réseau.

WiFiStateProperties

Propriétés

WiMAXProperties

Propriétés

  • AutoConnect

    booléen facultatif

    Indique si le réseau doit être connecté automatiquement.

  • EAP

    EAPProperties facultatif

    Propriétés EAP du réseau.

Méthodes

createNetwork()

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

Crée une configuration réseau à partir de propriétés. Si un réseau configuré correspondant existe déjà, cette opération échouera. Sinon, renvoie le GUID du nouveau réseau.

Paramètres

  • partagés

    booléen

    Si true, partagez cette configuration réseau avec d'autres utilisateurs.

    Cette option n'est disponible que dans l'interface utilisateur Web de Chrome.* Lorsque cette méthode est appelée par des applications, false est la seule valeur autorisée.

  • Propriétés permettant de configurer le nouveau réseau.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: string) => void

    • résultat

      chaîne

Renvoie

  • Promise<string>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

disableNetworkType()

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

Désactive tous les appareils correspondant au type de réseau spécifié. Consultez la note pour enableNetworkType.

Paramètres

enableNetworkType()

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

Active tous les appareils correspondant au type de réseau spécifié. Notez que le type peut représenter plusieurs types de réseaux (par exemple, "Sans fil").

Paramètres

forgetNetwork()

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

Oublie une configuration réseau en effaçant toutes les propriétés configurées pour le réseau avec le GUID networkGuid. Cela peut également inclure d'autres réseaux avec des identifiants correspondants (par exemple, le SSID et la sécurité du réseau Wi-Fi). Si aucune configuration de ce type n'existe, une erreur sera définie et l'opération échouera.

Dans les sessions de kiosque, cette méthode ne permet pas d'oublier les configurations réseau partagées.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à supprimer.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getCaptivePortalStatus()

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

Renvoie l'état du portail captif pour le réseau correspondant à "networkGuid".

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir l'état du portail captif.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: CaptivePortalStatus) => void

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDeviceStates()

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

Renvoie l'état des périphériques réseau disponibles.

Paramètres

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getGlobalPolicy()

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

Récupère les propriétés de la règle globale. Ces propriétés ne devraient pas changer au cours d'une session.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: GlobalPolicy) => void

Renvoie

  • Promise<GlobalPolicy>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getManagedProperties()

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

Récupère les propriétés fusionnées du réseau avec l'ID networkGuid à partir des sources suivantes : paramètres utilisateur, paramètres partagés, règles utilisateur, règles pour les appareils et paramètres actuellement actifs.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir les propriétés.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: ManagedProperties) => void

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getNetworks()

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

Renvoie une liste d'objets réseau avec les mêmes propriétés que celles fournies par getState. Un filtre est fourni pour spécifier le type de réseaux renvoyés et limiter leur nombre. Les réseaux sont classés par le système en fonction de leur priorité, les réseaux connectés ou en cours de connexion étant listés en premier.

Paramètres

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getProperties()

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

Récupère toutes les propriétés du réseau avec l'ID networkGuid. Inclut toutes les propriétés du réseau (valeurs en lecture seule et en lecture/écriture).

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir les propriétés.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: NetworkProperties) => void

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getState()

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

Récupère les propriétés en lecture seule mises en cache du réseau avec l'ID networkGuid. Cette fonction est censée être plus performante que getProperties, qui nécessite un aller-retour pour interroger le sous-système réseau. Les propriétés suivantes sont renvoyées pour tous les réseaux : GUID, Type, Name, WiFi.Security. Des propriétés supplémentaires sont fournies pour les réseaux visibles : ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel obtenir les propriétés.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (result: NetworkStateProperties) => void

Renvoie

  • Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

requestNetworkScan()

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

Demande au sous-système réseau de rechercher de nouveaux réseaux et de mettre à jour la liste renvoyée par getVisibleNetworks. Il ne s'agit que d'une requête : le sous-système réseau peut choisir de l'ignorer. Si la liste est mise à jour, l'événement onNetworkListChanged est déclenché.

Paramètres

  • networkType

    NetworkType facultatif

    Chrome 63 et versions ultérieures

    Si cette valeur est fournie, une analyse spécifique au type est demandée. Pour le réseau mobile, une recherche de réseau mobile est demandée si elle est prise en charge.

setProperties()

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

Définit les propriétés du réseau avec l'ID networkGuid. Cela n'est valable que pour les réseaux configurés (Source != None). Les réseaux visibles non configurés doivent utiliser createNetwork à la place. Dans les sessions en mode kiosque, l'appel de cette méthode sur un réseau partagé échouera.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau pour lequel définir les propriétés.

  • Propriétés à définir.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startConnect()

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

Démarre une connexion au réseau avec networkGuid.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau auquel se connecter.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startDisconnect()

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

Démarre une déconnexion du réseau avec networkGuid.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à déconnecter.

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    () => void

Renvoie

  • Promise<void>

    Chrome 125 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onDeviceStateListChanged

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

Déclenché lorsque la liste des appareils ou les propriétés de l'état d'un appareil ont été modifiées.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    () => void

onNetworkListChanged

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

Déclenché lorsque la liste des réseaux a changé. Envoie une liste complète des GUID de tous les réseaux actuels.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (changes: string[]) => void

    • modifications

      chaîne[]

onNetworksChanged

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

Déclenché lorsque les propriétés de l'un des réseaux sont modifiées. Envoie une liste de GUID pour les réseaux dont les propriétés ont changé.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (changes: string[]) => void

    • modifications

      chaîne[]

onPortalDetectionCompleted

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

Déclenché lorsqu'une détection de portail pour un réseau est terminée. Envoie le GUID du réseau et l'état du portail captif correspondant.

Paramètres