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 de kiosque Chrome OS 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 la casse CamelCase 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é"

"Activating" (Activation) 

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Énumération

"Unknown" (Inconnu)

"Hors connexion"

"En ligne"

"Portal" (Portail) 

"ProxyAuthRequired"

CellularProperties

Propriétés

  • ActivationState

    ActivationStateType facultatif

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

  • ActivationType

    chaîne facultatif

    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'appareil est à portée).

  • Famille

    chaîne facultatif

    Famille de technologies d'appareils mobiles : CDMA ou GSM.

  • FirmwareRevision

    chaîne facultatif

    Version du micrologiciel chargé dans le modem cellulaire.

  • FoundNetworks

    FoundNetworkProperties[] facultatif

    Liste des réseaux détectés lors de l'analyse réseau la plus récente.

  • HardwareRevision

    chaîne facultatif

    Version 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 facultatif

    Fabricant du modem cellulaire.

  • ModelID

    chaîne facultatif

    ID du modèle du modem cellulaire.

  • NetworkTechnology

    chaîne facultatif

    Si le modem est enregistré sur un réseau, la technologie réseau actuellement utilisée.

  • PaymentPortal

    PaymentPortal facultatif

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

  • RoamingState

    chaîne facultatif

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

  • SIMLockStatus

    SIMLockStatus facultatif

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

  • SIMPresent

    booléen facultatif

    Présence d'une carte SIM

  • Analyse

    booléen facultatif

    Chrome 63 ou version ultérieure

    "True" 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é du signal réseau actuelle.

  • 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 concatenaison du MCC (Mobile Country Code) et du MNC (Mobile Network Code) du réseau.

  • Pays

    chaîne facultatif

    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 ne correspond à ce modèle.

  • Émetteur

    IssuerSubjectPattern facultatif

    Si défini, format auquel les paramètres d'émetteur X.509 doivent correspondre.

  • IssuerCARef

    string[] facultatif

    Liste des certificats d'autorité de certification de l'émetteur de certificats. Un certificat doit être signé par l'une d'elles pour correspondre à ce modèle.

  • Objet

    IssuerSubjectPattern facultatif

    Si défini, format auquel les paramètres d'objet X.509 doivent correspondre.

ClientCertificateType

Énumération

"Ref"

"Pattern" (Modèle) 

ConnectionStateType

Énumération

"Connecté"

"Connexion"

"NotConnected"

DeviceStateProperties

Propriétés

  • SIMLockStatus

    SIMLockStatus facultatif

    Chrome 62 ou version ultérieure

    État du verrouillage de la carte SIM si Type = "Cellular" (Mobile) et SIMPresent = "True" (Vrai).

  • SIMPresent

    booléen facultatif

    Chrome 62 ou version ultérieure

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

  • Analyse

    booléen facultatif

    Indique si l'appareil est activé. "True" si l'appareil est actuellement en cours de numérisation.

  • É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'a pas été finalisé.

"Enabled" (Activé)
L'appareil est activé.

"Interdit"
L'appareil est interdit.

EAPProperties

Propriétés

  • AnonymousIdentity

    chaîne facultatif

  • ClientCertPKCS11Id

    chaîne facultatif

    Chrome 60 ou version ultérieure
  • ClientCertPattern

    CertificatePattern facultatif

  • ClientCertProvisioningProfileId

    chaîne facultatif

    Chrome 93 ou version ultérieure
  • ClientCertRef

    chaîne facultatif

  • ClientCertType

    ClientCertificateType

  • Identité

    chaîne facultatif

  • Interne

    chaîne facultatif

  • Externe

    chaîne facultatif

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

  • Mot de passe

    chaîne facultatif

  • SaveCredentials

    booléen facultatif

  • ServerCAPEMs

    string[] facultatif

  • ServerCARefs

    string[] facultatif

  • SubjectMatch

    ManagedDOMString facultatif

    Chrome 60 ou version ultérieure
  • UseProactiveKeyCaching

    booléen facultatif

  • UseSystemCAs

    booléen facultatif

EthernetProperties

Propriétés

  • Authentification

    chaîne facultatif

    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. Obligatoire pour l'authentification 8021X.

EthernetStateProperties

Propriétés

FoundNetworkProperties

Propriétés

  • LongName

    chaîne facultatif

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

  • NetworkId

    chaîne

    ID du réseau.

  • ShortName

    chaîne facultatif

    Nom court de l'opérateur 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 cette valeur est définie sur "True", seuls les réseaux de règles peuvent se connecter automatiquement. Valeur par défaut : "false".

  • AllowOnlyPolicyNetworksToConnect

    booléen facultatif

    Si cette valeur est définie sur "True", seuls les réseaux de règles peuvent être connectés. 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 cette valeur est définie sur "true" et qu'un réseau géré est disponible dans la liste des réseaux visibles, seuls les réseaux de stratégie peuvent être connectés. Aucun nouveau réseau ne peut être ajouté ni configuré. Valeur par défaut : "false".

  • BlockedHexSSIDs

    string[] facultatif

    Chrome 86 ou version ultérieure

    Liste des réseaux bloqués. Les connexions aux réseaux bloqués sont interdites. Vous pouvez débloquer à nouveau des 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 ou version ultérieure

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

  • Passerelle

    chaîne facultatif

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

  • IPAddress

    chaîne facultatif

    Adresse IP d'une connexion. Peut être une adresse IPv4 ou IPv6, en fonction de la valeur de Type.

  • IncludedRoutes

    string[] facultatif

    Chrome 76 ou version ultérieure

    Tableau de blocs d'adresses IP au format CIDR. Pour en savoir plus, consultez le fichier 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 ou version ultérieure

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

  • Type

    chaîne facultatif

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

  • WebProxyAutoDiscoveryUrl

    chaîne facultatif

    URL pour la découverte automatique du proxy Web, comme indiqué via DHCP.

IPConfigType

Énumération

"DHCP"

"Static" (Statique)

IssuerSubjectPattern

Propriétés

  • CommonName

    chaîne facultatif

    Si défini, valeur à laquelle faire correspondre le nom commun de l'objet du certificat.

  • Localité

    chaîne facultatif

    Si défini, valeur à laquelle faire correspondre l'emplacement commun de l'objet du certificat.

  • Organisation

    chaîne facultatif

    Si défini, valeur à laquelle faire correspondre les organisations de l'objet du certificat. Au moins une organisation doit correspondre à la valeur.

  • OrganizationalUnit

    chaîne facultatif

    Si défini, valeur à laquelle faire correspondre les unités organisationnelles de l'objet 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 un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été 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 à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    booléen facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    booléen facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    booléen facultatif

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

ManagedCellularProperties

Propriétés

ManagedDOMString

Propriétés

  • Actif

    chaîne facultatif

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

  • DeviceEditable

    booléen facultatif

    Indique si un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été définie par la règle). La valeur par défaut est false.

  • DevicePolicy

    chaîne facultatif

    Valeur de la propriété fournie par la règle relative à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    chaîne facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    chaîne facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    chaîne facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est 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 un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été 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 à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    string[] facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    string[] facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    string[] facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est 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 un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été 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 à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    IPConfigType facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    IPConfigType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est 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 un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été 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 à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    number facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    number facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    number facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est 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 un DevicePolicy existe pour la propriété et si la propriété peut être modifiée (c'est-à-dire si la valeur de propriété recommandée a été 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 à l'appareil.

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    ProxySettingsType facultatif

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

  • UserEditable

    booléen facultatif

    Indique si une stratégie utilisateur existe pour la propriété et si elle permet de la modifier (c'est-à-dire si la stratégie a défini une valeur de propriété recommandée). La valeur par défaut est false.

  • UserPolicy

    ProxySettingsType facultatif

    Valeur de la propriété fournie par la stratégie utilisateur.

  • UserSetting

    ProxySettingsType facultatif

    Valeur de la propriété définie par l'utilisateur connecté. Fourni uniquement si UserEditable est 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.

  • SOCKS

    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", n'incluez que les réseaux configurés (enregistrés). Valeur par défaut : "false".

  • limite

    number facultatif

    Nombre maximal de chaînes à renvoyer. Prend la valeur 1 000 par défaut s'il n'est pas spécifié. Utilisez 0 pour aucune limite.

  • networkType

    Type de réseau

    Type de réseaux à renvoyer.

  • visible

    booléen facultatif

    Si la valeur est "true", n'incluez que les réseaux visibles (connectés physiquement ou à portée). Valeur par défaut : "false".

NetworkProperties

Propriétés

  • Connexion cellulaire

    CellularProperties facultatif

    Pour les réseaux mobiles, les 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 du réseau.

  • ErrorState

    chaîne facultatif

    État de l'erreur réseau enregistré pour la dernière fois.

  • 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 des adresses IP du réseau.

  • IPConfigs

    IPConfigProperties[] facultatif

    Configuration IP du réseau

  • MacAddress

    chaîne facultatif

    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 facultatif

    Nom de réseau convivial.

  • NameServersConfigType

    IPConfigType facultatif

    Type de configuration IP des 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é du 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 facultatif

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "Aucune" 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 énumération SourceType.

  • StaticIPConfig

    IPConfigProperties facultatif

    Configuration 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 du réseau VPN.

  • 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

"Tout"

"Cellulaire"

"Ethernet"

"Tether"

"VPN"

"Sans fil"

"Wi-Fi"

PaymentPortal

Propriétés

  • Méthode

    chaîne

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

  • PostData

    chaîne facultatif

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

  • URL

    chaîne facultatif

    URL du portail de paiement.

ProxyLocation

Propriétés

  • Hôte

    chaîne

    Hôte de l'adresse IP du proxy.

  • Port

    Nombre

    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 proxy manuels : utilisés uniquement pour les paramètres de proxy Manual.

  • PAC

    chaîne facultatif

    URL du fichier de configuration automatique du proxy.

  • Type de paramètres de proxy.

ProxySettingsType

Énumération

"Direct" (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 de la carte SIM. Les valeurs possibles sont 'sim-pin', 'sim-puk' et ''.

  • RetriesLeft

    number facultatif

    Nombre de tentatives de verrouillage par code PIN autorisées avant que le code PUK ne soit requis pour déverrouiller la SIM.

ThirdPartyVPNProperties

Propriétés

  • ExtensionID

    chaîne

    ID de l'extension du fournisseur de VPN tiers.

  • ProviderName

    chaîne facultatif

    Nom du fournisseur VPN.

VPNProperties

Propriétés

  • AutoConnect

    booléen facultatif

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

  • Hôte

    chaîne facultatif

    L'hôte VPN.

  • Type

    chaîne facultatif

    Type de VPN. Il ne peut pas s'agir d'une énumération en raison de "L2TP-IPSec". Cette option est facultative pour NetworkConfigProperties, qui est transmise à setProperties, qui ne peut être utilisé que pour définir des propriétés spécifiques.

VPNStateProperties

Propriétés

WiFiProperties

Propriétés

  • AllowGatewayARPPolling

    booléen facultatif

    Obsolète depuis Chrome 131

    Supprimé dans M131. Aucune requête ARP active n'est actuellement effectuée.

  • AutoConnect

    booléen facultatif

    Indique si le réseau Wi-Fi doit se connecter automatiquement lorsqu'il est à portée.

  • BSSID

    chaîne facultatif

    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, 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 détectées pour le réseau Wi-Fi.

  • HexSSID

    chaîne facultatif

    Copie encodé en hexadécimal du SSID du réseau.

  • HiddenSSID

    booléen facultatif

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

  • Phrase secrète

    chaîne facultatif

    Chrome 66 ou version ultérieure

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

  • RoamThreshold

    number facultatif

    Obsolète, ignoré.

  • SSID

    chaîne facultatif

    SSID du réseau.

  • Sécurité

    chaîne facultatif

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

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

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

Paramètres

  • partagés

    booléen

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

    Cette option n'est exposée qu'à l'interface utilisateur Web de Chrome.* Lorsqu'elle est appelée par des applications, false est la seule valeur autorisée.

  • Propriétés à utiliser pour configurer le nouveau réseau.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

disableNetworkType()

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

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

Paramètres

enableNetworkType()

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

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

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

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 Wi-Fi). Si aucune configuration de ce type n'existe, une erreur sera définie et l'opération échouera.

Dans les sessions de borne, cette méthode ne permet pas de supprimer les configurations réseau partagées.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à supprimer.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getCaptivePortalStatus()

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

Indique 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.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getDeviceStates()

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

Affiche les états des appareils réseau disponibles.

Paramètres

Renvoie

  • Chrome 125 et versions ultérieures

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

getGlobalPolicy()

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

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

Paramètres

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getManagedProperties()

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

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

Paramètres

  • networkGuid

    chaîne

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

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getNetworks()

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

Renvoie une liste d'objets réseau avec les mêmes propriétés 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 trié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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getProperties()

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

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 des propriétés.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getState()

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

Récupère les propriétés en lecture seule mises en cache du réseau avec l'ID networkGuid. Il s'agit d'une fonction 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 des propriétés.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

requestNetworkScan()

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

Demande au sous-système de mise en 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 ou version ultérieure

    Si fourni, demande une analyse spécifique au type. Pour les réseaux mobiles, une analyse du réseau mobile est demandée si elle est prise en charge.

setProperties()

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

Définit les propriétés du réseau avec l'ID networkGuid. Cette valeur n'est valide que pour les réseaux configurés (Source != None). Les réseaux visibles non configurés doivent utiliser createNetwork à la place. Dans les sessions de borne, 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 des propriétés.

  • Propriétés à définir.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startConnect()

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

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

Paramètres

  • networkGuid

    chaîne

    GUID du réseau auquel se connecter.

  • rappel

    fonction 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 versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

startDisconnect()

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

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

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à partir duquel vous souhaitez vous déconnecter.

  • rappel

    fonction 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 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 a changé ou que des propriétés d'état de l'appareil ont changé.

Paramètres

  • rappel

    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 chaînes a changé. Envoie une liste complète des GUID pour tous les réseaux actuels.

Paramètres

  • rappel

    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 changent sur l'un des réseaux. Envoie une liste de GUID pour les réseaux dont les propriétés ont changé.

Paramètres

  • rappel

    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é à la fin de la détection d'un portail pour un réseau. Envoie le GUID du réseau et l'état du portail captif correspondant.

Paramètres