Fonctionnalités et EdgeOptions

Les fonctionnalités sont des options que vous pouvez utiliser pour personnaliser et configurer une EdgeDriver session. Pour en savoir plus sur le démarrage d’une nouvelle EdgeDriver session, consultez Automatisation de Microsoft Edge. Cet article décrit toutes les fonctionnalités prises en charge pour Microsoft Edge et fournit des détails sur le passage des fonctionnalités aux EdgeDriver sessions.

Les fonctionnalités sont transmises à une session WebDriver sous la forme d’un mappage JSON, mais il n’est pas nécessaire ou recommandé de les définir de cette façon. Les frameworks de test WebDriver (tels que Selenium) fournissent des liaisons de langage qui ont généralement des méthodes pratiques. Vous n’avez donc pas besoin de configurer la carte JSON vous-même. Par exemple, Selenium configure les fonctionnalités via la EdgeOptions classe .

Pour en savoir plus sur la configuration des fonctionnalités, consultez la documentation de votre infrastructure de test WebDriver préférée. Pour plus d’informations, consultez Choisir une infrastructure de test WebDriver.

Utilisation de la classe EdgeOptions

Créez une instance de EdgeOptions, qui fournit des méthodes pratiques pour définir des fonctionnalités spécifiques à Microsoft Edge. Après avoir configuré l’objet EdgeOptions , passez EdgeOptions au EdgeDriver constructeur.

var options = new EdgeOptions();
options.AddExtensions("/path/to/extension.crx");
var driver = new EdgeDriver(options);

Pour utiliser des fonctionnalités qui n’ont pas de méthode pratique associée, utilisez la AddAdditionalEdgeOption méthode . Vous devez transmettre le nom complet de la fonctionnalité et une valeur avec le type correct. Pour obtenir la liste complète des fonctionnalités et des types de valeurs acceptés, consultez Objet EdgeOptions.

options.AddAdditionalEdgeOption("wdpAddress", "remotehost:50080");

Fonctionnalités reconnues

Pour connaître les fonctionnalités standard qui EdgeDriver acceptent, consultez la documentation Selenium et la norme W3C WebDriver. Cet article répertorie uniquement les fonctionnalités propres à Microsoft Edge.

Objet EdgeOptions

La plupart des fonctionnalités spécifiques de Microsoft Edge sont exposées via l’objet EdgeOptions . Dans certains langages, les fonctionnalités sont implémentées par la EdgeOptions classe . Dans d’autres langues, les fonctionnalités sont stockées sous le ms:edgeOptions dictionnaire dans DesiredCapabilities.

Fonctionnalité	Type	Détails
args	liste de chaînes	Liste des arguments de ligne de commande à passer au processus Microsoft Edge au lancement. Les arguments avec une valeur associée doivent être séparés par un = signe (par exemple, ['start-maximized', 'user-data-dir=/tmp/temp_profile']). Si vous lancez une application WebView2, ces arguments sont passés à votre application au lieu du processus de navigateur Microsoft Edge sous-jacent. Pour passer des arguments au processus du navigateur lors du lancement d’une application WebView2, utilisez plutôt webviewOptions.additionalBrowserArguments .
binary	chaîne	Chemin d’accès au fichier binaire Microsoft Edge à utiliser (sur macOS, le chemin d’accès doit être le binaire réel, pas seulement l’application. par exemple, /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge).
debuggerAddress	chaîne	Adresse d’un serveur de débogueur auquel se connecter, sous la forme , hostname/ip:portpar exemple 127.0.0.1:38947.
detach	valeur booléenne	Valeur par défaut = false. Si falsela valeur est , Microsoft Edge se ferme lorsque le service WebDriver s’arrête, même si l’extrémité locale de WebDriver n’a pas fermé la session. Si la valeur est true, Microsoft Edge ne se ferme que si la fin locale de WebDriver ferme la session. Si true, et que l’extrémité locale de WebDriver ne ferme pas la session, EdgeDriver n’propre pas le dossier de données utilisateur temporaire utilisé par le instance Microsoft Edge.
excludeSwitches	liste de chaînes	Liste des commutateurs de ligne de commande Microsoft Edge pour exclure que EdgeDriver par défaut passe lors du démarrage de Microsoft Edge. Évitez le -- préfixe pour les commutateurs.
extensions	liste de chaînes	Liste des extensions à installer au démarrage. Chaque élément de la liste doit être une extension pack encodée en base 64 (.crx).
localState	Dictionary	Dictionnaire avec chaque entrée composée du nom de la préférence et de la valeur. Les préférences sont appliquées au fichier d’état local dans le dossier de données utilisateur.
minidumpPath	chaîne	Répertoire pour stocker les minidumps Microsoft Edge. (Pris en charge uniquement sur Linux.)
mobileEmulation	Dictionary	Dictionnaire avec une valeur pour deviceNameou des valeurs pour deviceMetrics et userAgent.
perfLoggingPrefs	Dictionary	Dictionnaire facultatif qui spécifie les préférences de journalisation des performances. Pour plus d’informations, consultez objet perfLoggingPrefs.
prefs	Dictionary	Dictionnaire avec chaque entrée composée du nom de la préférence et de la valeur. Les préférences sont appliquées uniquement au profil utilisateur en cours d’utilisation. Pour obtenir des exemples, consultez le Preferences fichier dans le dossier de données utilisateur de Microsoft Edge.
wdpAddress	string	Adresse d’un serveur Windows Device Portal auquel se connecter, sous la forme , hostname/ip:portpar exemple 127.0.0.1:50080. Pour plus d’informations, consultez Débogage à distance - Windows 10 appareils.
wdpPassword	chaîne	Mot de passe facultatif à utiliser lors de la connexion à un serveur Portail d’appareil Windows. Obligatoire si l’authentification est activée sur le serveur.
wdpUsername	chaîne	Nom d’utilisateur facultatif à utiliser lors de la connexion à un serveur Portail d’appareil Windows. Obligatoire si l’authentification est activée sur le serveur.
wdpProcessId	entier	ID de processus requis à utiliser en cas d’attachement à une application UWP WebView2 en cours d’exécution, par exemple 36590. Vous trouverez ces informations dans browserProcessId sur http://<Device Portal URL>/msedge.
webviewOptions	Dictionary	Dictionnaire facultatif qui peut être utilisé pour configurer l’environnement WebView2 lors du lancement d’une application WebView2. Pour plus d’informations, consultez l’objet webviewOptions.
windowsApp	chaîne	ID de modèle utilisateur d’application d’un package d’application Microsoft Edge à lancer, par exemple Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE. Utilisez windowsApp au lieu de lors de binary la connexion à un appareil Windows 10X ou à un émulateur à l’aide du portail d’appareil Windows.
windowTypes	liste de chaînes	Liste des types de fenêtres affichés dans la liste des handles de fenêtre. Pour accéder aux éléments webview Android, incluez webview dans la liste.

objet perfLoggingPrefs

Le perfLoggingPrefs dictionnaire a le format suivant. Toutes les clés sont facultatives.

Clé	Type	Valeur par défaut	Détails
bufferUsageReportingInterval	entier positif	1000	Nombre demandé de millisecondes entre les événements d’utilisation de la mémoire tampon de trace DevTools. Par exemple, si 1 000, une fois par seconde, DevTools signale le niveau de remplissage de la mémoire tampon de trace. Si un rapport indique que l’utilisation de la mémoire tampon est de 100 %, un avertissement est émis.
enableNetwork	valeur booléenne	true	Pour collecter (ou ne pas collecter) des événements à partir du domaine réseau.
enablePage	valeur booléenne	true	Pour collecter (ou ne pas collecter) des événements à partir du domaine Page.
traceCategories	string	(vide)	Chaîne séparée par des virgules des catégories de suivi Microsoft Edge pour lesquelles les événements de trace doivent être collectés. Une chaîne non spécifiée ou vide désactive le suivi.

objet webviewOptions

Le webviewOptions dictionnaire est utilisé pour configurer l’environnement WebView2 lors du lancement d’une application WebView2. Il a le format suivant. Toutes les clés sont facultatives.

Clé	Type	Valeur par défaut	Détails
browserExecutableFolder	chaîne	(vide)	Chemin d’accès à un dossier contenant une version fixe du runtime WebView2 à utiliser. Pour plus d’informations sur l’utilisation d’une distribution de runtime de version fixe avec WebView2, consultez Distribuer une application WebView2 et le runtime WebView2.
userDataFolder	string	(vide)	Chemin d’accès au dossier de données utilisateur que WebView2 utilisera. Si userDataFolder n’est pas spécifié, Microsoft Edge WebDriver crée un dossier de données utilisateur temporaire. Pour plus d’informations sur la gestion du dossier de données utilisateur avec WebView2, consultez Gérer le dossier de données utilisateur.
additionalBrowserArguments	liste de chaînes		Liste des arguments de ligne de commande que WebView2 transmettra au processus du navigateur au lancement. Les arguments avec une valeur associée doivent être séparés par un = signe (par exemple, ['start-maximized', 'log-level=0']).
releaseChannelPreference	string		Distribution d’exécution persistante WebView2 préférée à utiliser. Peut être "stable" ou "canary".

Fonctionnalités retournées

La liste suivante contient toutes les fonctionnalités propres à Microsoft Edge qui retournent EdgeDriver lorsque vous créez une session.

Fonctionnalité	Type	Détails
msedge.msedgedriverVersion	string	Version de EdgeDriver.
msedge.userDataDir	string	Chemin d’accès au dossier de données utilisateur utilisé par le instance Microsoft Edge.