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 Microsoft Edge. Cet article décrit toutes les fonctionnalités prises en charge pour Microsoft Edge et fournit des détails sur la transmission des fonctionnalités aux EdgeDriver sessions.

Les fonctionnalités sont transmises à une session WebDriver sous la forme d’une carte 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 afin que vous n’ayez pas besoin de configurer la carte JSON vous-même. Par exemple, Selenium configure des 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 acceptées et des types valeur, consultez l’objet EdgeOptions.

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

Fonctionnalités reconnues

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

EdgeOptions (objet)

La plupart des fonctionnalités spécifiques à Microsoft Edge sont exposées via l’objetEdgeOptions. Dans certaines langues, 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 transmettre des arguments au processus de 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, et pas seulement l’application. par exemple, /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge).
debuggerAddress chaîne Adresse d’un serveur débogueur auquel se connecter, sous la forme , hostname/ip:portpar exemple 127.0.0.1:38947.
detach booléen Valeur par défaut = false. Si false, 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 true, Microsoft Edge quitte uniquement si l’extrémité locale de WebDriver ferme la session. Si truela fin locale de WebDriver ne ferme pas la session, EdgeDriver ne nettoie pas le dossier de données utilisateur temporaire utilisé par l’instance Microsoft Edge.
excludeSwitches liste de chaînes Liste des commutateurs de ligne de commande Microsoft Edge pour exclure ce EdgeDriver par défaut lors du démarrage Microsoft Edge. Évitez le -- préfixe des commutateurs.
extensions liste de chaînes Liste des extensions à installer au démarrage. Chaque élément de la liste doit être une extension packed encodée en base 64 (.crx).
localState dictionnaire 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 État local dans le dossier de données utilisateur.
minidumpPath chaîne Répertoire pour stocker Microsoft Edge minidumps. (Pris en charge uniquement sur Linux.)
mobileEmulation dictionnaire Dictionnaire avec une valeur pour deviceName, ou des valeurs pour deviceMetrics et userAgent.
perfLoggingPrefs dictionnaire Dictionnaire facultatif qui spécifie les préférences de journalisation des performances. Pour plus d’informations, consultez l’objet perfLoggingPrefs.
prefs dictionnaire 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 utilisé. Pour obtenir des exemples, consultez le Preferences fichier dans le dossier de données utilisateur de Microsoft Edge.
wdpAddress chaîne Adresse d’un serveur Windows Portail d’appareil à laquelle se connecter, sous la forme , hostname/ip:portpar exemple 127.0.0.1:50080. Pour plus d’informations, consultez Débogage à distance - appareils Windows 10.
wdpPassword chaîne Mot de passe facultatif à utiliser lors de la connexion à un serveur Windows Device Portal. Obligatoire si l’authentification est activée sur le serveur.
wdpUsername chaîne Nom d’utilisateur facultatif à utiliser lors de la connexion à un serveur Windows Device Portal. Obligatoire si l’authentification est activée sur le serveur.
webviewOptions dictionnaire 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 plutôt windowsApp que de binary vous connecter à un appareil ou à un émulateur Windows 10X à l’aide de Windows Portail d’appareil.
windowTypes liste de chaînes Liste des types de fenêtres qui sont affichés dans la liste des handles de fenêtre. Pour accéder à Android éléments webview, 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 la valeur est 1000, puis une fois par seconde, DevTools indique à quel point la mémoire tampon de trace est complète. Si un rapport indique que l’utilisation de la mémoire tampon est de 100 %, un avertissement est émis.
enableNetwork booléen true Pour collecter (ou ne pas collecter) des événements à partir du domaine réseau.
enablePage booléen true Pour collecter (ou ne pas collecter) des événements à partir du domaine de page.
traceCategories chaîne (vide) Chaîne séparée par des virgules de Microsoft Edge catégories de suivi pour lesquelles les événements de trace doivent être collectés. Une chaîne non spécifiée ou vide désactive le suivi.

webviewOptions (objet)

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 chaîne (vide) Chemin d’accès au dossier de données utilisateur que WebView2 utilisera. S’il 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 transmet au processus de 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 chaîne Distribution du runtime persistant WebView2 préférée à utiliser. Peut être "stable" ou "canary".

Fonctionnalités retournées

La liste suivante contient toutes les fonctionnalités spécifiques à Microsoft Edge qui EdgeDriver sont retournées lorsque vous créez une session.

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