chrome.networking.onc

Description

L'API chrome.networking.onc permet de configurer les connexions réseau (cellulaire, 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).

NOTE : La plupart des propriétés de dictionnaire et des valeurs d'énumération utilisent la casse 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é"

"Activating"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Énumération

"Unknown"

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

    Type d'activation du réseau mobile.

  • AllowRoaming

    boolean facultatif

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

  • AutoConnect

    boolean facultatif

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

  • Famille

    chaîne facultatif

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

  • FirmwareRevision

    chaîne facultatif

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

  • FoundNetworks

    FoundNetworkProperties[] facultatif

    Liste des réseaux détectés lors de la dernière analyse du réseau.

  • HardwareRevision

    chaîne facultatif

    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 facultatif

    Fabricant du modem cellulaire.

  • ModelID

    chaîne facultatif

    ID du modèle de 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 un forfait de données mobiles ou le modifier.

  • 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 de la famille GSM.

  • SIMPresent

    boolean facultatif

    Si une carte SIM est présente.

  • Analyse

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

  • SupportNetworkScan

    boolean 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 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 correspondant à ce format n'est trouvé.

  • Émetteur

    IssuerSubjectPattern facultatif

    Si ce champ est défini, il s'agit du format auquel les paramètres de l'émetteur X.509 doivent correspondre.

  • IssuerCARef

    string[] facultatif

    Liste des certificats CA de l'émetteur de certificats. Un certificat doit être signé par l'une d'elles pour correspondre à ce format.

  • Objet

    IssuerSubjectPattern facultatif

    S'il est défini, modèle auquel les paramètres de l'objet X.509 doivent correspondre.

ClientCertificateType

Énumération

"Ref"

"Pattern"

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 et SIMPresent = True.

  • SIMPresent

    boolean facultatif

    Chrome 62 ou version ultérieure

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

  • Analyse

    boolean facultatif

    Indique si l'appareil est activé. "True" si l'appareil est en cours d'analyse.

  • État actuel de l'appareil.

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

DeviceStateType

Énumération

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

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

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

"Activé"
L'appareil est activé.

"Prohibited"
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. Requis par l'ONC, mais peut ne pas être fourni lors de la traduction à partir de Shill.

  • Mot de passe

    chaîne facultatif

  • SaveCredentials

    boolean facultatif

  • ServerCAPEMs

    string[] facultatif

  • ServerCARefs

    string[] facultatif

  • SubjectMatch

    ManagedDOMString facultatif

    Chrome 60 ou version ultérieure
  • UseProactiveKeyCaching

    boolean facultatif

  • UseSystemCAs

    boolean 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

    boolean 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 au format long de l'opérateur réseau.

  • NetworkId

    chaîne

    ID du réseau.

  • ShortName

    chaîne facultatif

    Nom au format 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

    boolean facultatif

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

  • AllowOnlyPolicyNetworksToConnect

    boolean 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

    boolean facultatif

    Chrome 70 ou version ultérieure

    Si la règle 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 règles peuvent être connectés, et 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. Les réseaux peuvent être débloqués 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 onc_spec.md.

  • Passerelle

    chaîne facultatif

    Adresse de passerelle utilisée pour la configuration IP.

  • IPAddress

    chaîne facultatif

    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 ou version ultérieure

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

    L'URL de la découverte automatique du proxy Web, telle qu'elle est signalée par DHCP.

IPConfigType

Énumération

"DHCP"

"Statique"

IssuerSubjectPattern

Propriétés

  • CommonName

    chaîne facultatif

    Si elle est définie, valeur par rapport à laquelle le nom commun de l'objet du certificat doit être mis en correspondance.

  • Localité

    chaîne facultatif

    Si elle est définie, valeur par rapport à laquelle l'emplacement commun du sujet du certificat doit être mis en correspondance.

  • Organisation

    chaîne facultatif

    Si elle 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 facultatif

    Si elle est définie, valeur par rapport à laquelle les unités organisationnelles du sujet du certificat doivent être mises en correspondance. Au moins une unité organisationnelle doit correspondre à la valeur.

ManagedBoolean

Propriétés

  • Actif

    boolean facultatif

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

  • DeviceEditable

    boolean facultatif

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

  • DevicePolicy

    boolean facultatif

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

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    boolean facultatif

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

  • UserEditable

    boolean facultatif

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

  • UserPolicy

    boolean facultatif

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

  • UserSetting

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

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

  • DeviceEditable

    boolean facultatif

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

  • DevicePolicy

    chaîne facultatif

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

  • En vigueur

    chaîne facultatif

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

  • SharedSetting

    chaîne facultatif

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

  • UserEditable

    boolean facultatif

    Indique si une règle UserPolicy existe pour la propriété et permet de la modifier (c'est-à-dire que la règle définit la 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 règle utilisateur.

  • UserSetting

    chaîne facultatif

    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

    boolean facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (c'est-à-dire que la règle définit la valeur de propriété recommandée). 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 facultatif

    Source à partir de laquelle la valeur de la 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

    boolean facultatif

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

  • UserPolicy

    string[] facultatif

    Valeur de la propriété fournie par la règle 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

    boolean facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (c'est-à-dire que la règle définit la valeur de propriété recommandée). 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 facultatif

    Source à partir de laquelle la valeur de la 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

    boolean facultatif

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

  • UserPolicy

    IPConfigType facultatif

    Valeur de la propriété fournie par la règle 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

    boolean facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (c'est-à-dire que la règle définit la valeur de propriété recommandée). 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 facultatif

    Source à partir de laquelle la valeur de la 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

    boolean facultatif

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

  • UserPolicy

    number facultatif

    Valeur de la propriété fournie par la règle 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

    boolean facultatif

    Indique si une règle DevicePolicy existe pour la propriété et permet de la modifier (c'est-à-dire que la règle définit la valeur de propriété recommandée). 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 facultatif

    Source à partir de laquelle la valeur de la 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

    boolean facultatif

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

  • UserPolicy

    ProxySettingsType facultatif

    Valeur de la propriété fournie par la règle 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.

  • 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

    boolean facultatif

    Si la valeur est "true", n'incluez que les réseaux configurés (enregistrés). La valeur par défaut est "false".

  • limite

    number facultatif

    Nombre maximal de réseaux à renvoyer. Si aucune valeur n'est spécifiée, la valeur par défaut est 1 000. Utilisez 0 pour ne pas appliquer de limite.

  • networkType

    Type de réseau

    Type de réseaux à renvoyer.

  • visible

    boolean facultatif

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

NetworkProperties

Propriétés

  • Mobile

    CellularProperties facultatif

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

  • Connectable

    boolean facultatif

    Indique si le réseau est connectable.

  • ConnectionState

    ConnectionStateType facultatif

    État de connexion actuel du réseau.

  • ErrorState

    chaîne facultatif

    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

    Le GUID du réseau.

  • IPAddressConfigType

    IPConfigType facultatif

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

  • IPConfigs

    IPConfigProperties[] facultatif

    Configuration IP du réseau.

  • MacAddress

    chaîne facultatif

    Adresse MAC du réseau.

  • Facturé à l'usage

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

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

    Indique si le réseau est configuré et comment. Valeurs possibles :

    • 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 ou version ultérieure

    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 VPN 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

"All"

"Cellulaire"

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

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

  • URL

    chaîne facultatif

    L'URL du portail de paiement.

ProxyLocation

Propriétés

  • Hôte

    chaîne

    L'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 proxy manuels sont exclus.

  • Manuel

    ManualProxySettings facultatif

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

  • PAC

    chaîne facultatif

    URL du fichier de configuration automatique du proxy.

  • Type de paramètres proxy.

ProxySettingsType

Énumération

"Direct"

"Manual"

"PAC"

"WPAD"

SIMLockStatus

Propriétés

  • LockEnabled

    booléen

    Indique si le verrouillage de 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 déverrouillage par 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 facultatif

    Nom du fournisseur de VPN.

VPNProperties

Propriétés

  • AutoConnect

    boolean 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 transmis à setProperties, qui peut être utilisé pour ne définir que des propriétés spécifiques.

VPNStateProperties

Propriétés

WiFiProperties

Propriétés

  • AllowGatewayARPPolling

    boolean facultatif

    Obsolète depuis Chrome 131

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

  • AutoConnect

    boolean facultatif

    Indique si l'appareil doit se connecter automatiquement au réseau Wi-Fi 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 sur 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ée en hexadécimal du SSID du réseau.

  • HiddenSSID

    boolean facultatif

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

  • Phrase secrète

    chaîne facultatif

    Chrome 66 ou version ultérieure

    Phrase secrète pour les connexions WEP/WPA/WPA2. Cette propriété ne peut être que définie. Les propriétés renvoyées par getProperties ne contiendront 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é réseau.

  • SignalStrength

    number facultatif

    Intensité du signal réseau.

WiFiStateProperties

Propriétés

WiMAXProperties

Propriétés

  • AutoConnect

    boolean 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à, 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'il est appelé 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 ou version ultérieure

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

Dans les sessions kiosque, cette méthode ne pourra pas oublier les configurations réseau partagées.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau à oublier.

  • callback

    function facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 125 ou version ultérieure

    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 ou version ultérieure

    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 ou version ultérieure

    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 ou version ultérieure

    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 relatives aux utilisateurs, règles relatives aux appareils et paramètres actuellement actifs.

Paramètres

  • networkGuid

    chaîne

    GUID du réseau dont vous souhaitez obtenir les propriétés.

  • callback

    function facultatif

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

    (result: ManagedProperties) => void

Renvoie

  • Chrome 125 ou version ultérieure

    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 le nombre de réseaux. 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 ou version ultérieure

    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 dont vous souhaitez obtenir les propriétés.

  • callback

    function facultatif

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

    (result: NetworkProperties) => void

Renvoie

  • Chrome 125 ou version ultérieure

    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 dont vous souhaitez obtenir les propriétés.

  • callback

    function facultatif

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

    (result: NetworkStateProperties) => void

Renvoie

  • Chrome 125 ou version ultérieure

    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 ou version ultérieure

    Si cette option est fournie, elle demande une analyse spécifique au type. Pour les réseaux mobiles, une recherche de réseau mobile sera 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 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 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 des 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 ou version ultérieure

    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 ou version ultérieure

    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 duquel se déconnecter.

  • callback

    function facultatif

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

    () => void

Renvoie

  • Promise<void>

    Chrome 125 ou version ultérieure

    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 d'état d'un appareil ont changé.

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

Se déclenche 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

  • 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