Funcionalidades y EdgeOptions

Las funcionalidades son opciones que puede usar para personalizar y configurar una EdgeDriver sesión. Para obtener información sobre cómo iniciar una nueva EdgeDriver sesión, consulte Automatización de Microsoft Edge. En este artículo se describen todas las funcionalidades admitidas para Microsoft Edge y se proporcionan detalles sobre cómo pasar las funcionalidades a EdgeDriver las sesiones.

Las funcionalidades se pasan a una sesión de WebDriver como un mapa JSON, pero no es necesario ni se recomienda establecerlas de esta manera. Los marcos de prueba de WebDriver (como Selenium) proporcionan enlaces de lenguaje que suelen tener métodos prácticos, por lo que no es necesario configurar el mapa JSON usted mismo. Por ejemplo, Selenium configura las funcionalidades a través de la EdgeOptions clase .

Para más información sobre cómo configurar funcionalidades, consulte la documentación del marco de pruebas de WebDriver preferido. Para obtener más información, vea Elegir un marco de pruebas de WebDriver.

Uso de la clase EdgeOptions

Cree una instancia de EdgeOptions, que proporciona métodos prácticos para establecer funcionalidades específicas de Microsoft Edge. Después de configurar el EdgeOptions objeto, pase EdgeOptions al EdgeDriver constructor.

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

Para usar funcionalidades que no tienen un método de comodidad asociado, use el AddAdditionalEdgeOption método . Debe pasar el nombre completo de la funcionalidad y un valor con el tipo correcto. Para obtener la lista completa de funcionalidades aceptadas y tipos de valor, vea EdgeOptions (objeto).

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

Funcionalidades reconocidas

Para ver las funcionalidades estándar que EdgeDriver acepta, consulte la documentación de Selenium y el estándar W3C WebDriver. En este artículo solo se enumeran las funcionalidades específicas de Microsoft Edge.

EdgeOptions (objeto)

La mayoría de las funcionalidades específicas de Microsoft Edge se exponen a través del EdgeOptions objeto . En algunos lenguajes, la clase implementa EdgeOptions las funcionalidades. En otros lenguajes, las funcionalidades se almacenan en el ms:edgeOptions diccionario de DesiredCapabilities.

Funcionalidad	Tipo	Detalles
args	lista de cadenas	Lista de argumentos de línea de comandos que se van a pasar al proceso de Microsoft Edge al iniciarse. Los argumentos con un valor asociado deben estar separados por un = signo (por ejemplo, ['start-maximized', 'user-data-dir=/tmp/temp_profile']). Si va a iniciar una aplicación WebView2, estos argumentos se pasan a la aplicación en lugar del proceso subyacente del explorador Microsoft Edge. Para pasar argumentos al proceso del explorador al iniciar una aplicación WebView2, use webviewOptions.additionalBrowserArguments en su lugar.
binary	string	Ruta de acceso al binario de Microsoft Edge que se va a usar (en macOS, la ruta de acceso debe ser el binario real, no solo la aplicación. Por ejemplo, /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge).
debuggerAddress	string	Dirección de un servidor del depurador al que se va a conectar, en forma de hostname/ip:port, por ejemplo 127.0.0.1:38947.
detach	booleano	Valor predeterminado = false. Si falsees , Microsoft Edge se cierra cuando se cierra el servicio WebDriver, incluso si el extremo local de WebDriver no ha cerrado la sesión. Si truees , Microsoft Edge solo se cierra si el final local de WebDriver cierra la sesión. Si true, y el final local de WebDriver no cierra la sesión, EdgeDriver no limpia la carpeta de datos de usuario temporal que usa la instancia de Microsoft Edge.
excludeSwitches	lista de cadenas	Lista de modificadores de línea de comandos de Microsoft Edge para excluir que EdgeDriver pasa de forma predeterminada al iniciar Microsoft Edge. Evite el -- prefijo de los modificadores.
extensions	lista de cadenas	Lista de extensiones que se instalarán al iniciarse. Cada elemento de la lista debe ser una extensión empaquetada codificada en base 64 (.crx).
localState	Diccionario	Diccionario con cada entrada que consta del nombre de la preferencia y del valor. Las preferencias se aplican al archivo de estado local de la carpeta de datos del usuario.
minidumpPath	string	Directorio para almacenar minivolcados de Microsoft Edge. (Solo se admite en Linux).
mobileEmulation	Diccionario	Diccionario con un valor para deviceName, o valores para deviceMetrics y userAgent.
perfLoggingPrefs	Diccionario	Diccionario opcional que especifica las preferencias de registro de rendimiento. Para obtener más información, vea perfLoggingPrefs (objeto).
prefs	Diccionario	Diccionario con cada entrada que consta del nombre de la preferencia y del valor. Las preferencias solo se aplican al perfil de usuario en uso. Para obtener ejemplos, vea el Preferences archivo en la carpeta de datos de usuario de Microsoft Edge.
wdpAddress	string	Dirección de un servidor de Windows Device Portal al que conectarse, en forma de hostname/ip:port, por ejemplo 127.0.0.1:50080. Para obtener más información, vea Depuración remota: Windows 10 dispositivos.
wdpPassword	string	Contraseña opcional que se usará al conectarse a un servidor de Windows Device Portal. Obligatorio si el servidor tiene habilitada la autenticación.
wdpUsername	string	Nombre de usuario opcional que se usará al conectarse a un servidor de Windows Device Portal. Obligatorio si el servidor tiene habilitada la autenticación.
wdpProcessId	integer	Identificador de proceso necesario que se debe usar si se asocia a una aplicación para UWP de WebView2 en ejecución, por ejemplo 36590. Esta información se puede encontrar en browserProcessId en http://<Device Portal URL>/msedge.
webviewOptions	Diccionario	Diccionario opcional que se puede usar para configurar el entorno WebView2 al iniciar una aplicación WebView2. Para obtener más información, vea webviewOptions (objeto).
windowsApp	string	Identificador del modelo de usuario de la aplicación de un paquete de aplicación de Microsoft Edge que se va a iniciar, por ejemplo Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE. Use windowsApp en lugar de binary al conectarse a un dispositivo o emulador de Windows 10X mediante Windows Device Portal.
windowTypes	lista de cadenas	Lista de tipos de ventana que se muestran en la lista de identificadores de ventana. Para obtener acceso a los elementos de vista web de Android, incluya webview en la lista.

perfLoggingPrefs (objeto)

El perfLoggingPrefs diccionario tiene el siguiente formato. Todas las claves son opcionales.

Key	Tipo	Valor predeterminado	Detalles
bufferUsageReportingInterval	entero positivo	1000	Número solicitado de milisegundos entre los eventos de uso del búfer de seguimiento de DevTools. Por ejemplo, si 1000, una vez por segundo, DevTools informa de lo completo que es el búfer de seguimiento. Si un informe indica que el uso del búfer es del 100 %, se emite una advertencia.
enableNetwork	booleano	true	Para recopilar (o no recopilar) eventos del dominio de red.
enablePage	booleano	true	Para recopilar (o no recopilar) eventos del dominio de página.
traceCategories	string	(vacío)	Cadena separada por comas de categorías de seguimiento de Microsoft Edge para la que se deben recopilar eventos de seguimiento. Una cadena no especificada o vacía deshabilita el seguimiento.

webviewOptions (objeto)

El webviewOptions diccionario se usa para configurar el entorno WebView2 al iniciar una aplicación WebView2. Tiene el siguiente formato. Todas las claves son opcionales.

Key	Tipo	Valor predeterminado	Detalles
browserExecutableFolder	string	(vacío)	Ruta de acceso a una carpeta que contiene una versión fija en tiempo de ejecución de WebView2 que se va a usar. Para obtener más información sobre el uso de una distribución en tiempo de ejecución de versión fija con WebView2, consulte Distribución de una aplicación WebView2 y el entorno de ejecución de WebView2.
userDataFolder	string	(vacío)	Ruta de acceso a la carpeta de datos de usuario que usará WebView2. Si userDataFolder no se especifica, Microsoft Edge WebDriver creará una carpeta de datos de usuario temporal. Para obtener más información sobre cómo administrar la carpeta de datos de usuario con WebView2, vea Administrar la carpeta de datos de usuario.
additionalBrowserArguments	lista de cadenas		Lista de argumentos de línea de comandos que WebView2 pasará al proceso del explorador al iniciarse. Los argumentos con un valor asociado deben estar separados por un = signo (por ejemplo, ['start-maximized', 'log-level=0']).
releaseChannelPreference	string		Distribución de tiempo de ejecución perenne de WebView2 preferida que se va a usar. Puede ser "stable" o "canary".

Funcionalidades devueltas

La lista siguiente contiene todas las funcionalidades específicas de Microsoft Edge que EdgeDriver se devuelven al crear una nueva sesión.

Funcionalidad	Tipo	Detalles
msedge.msedgedriverVersion	string	Versión de EdgeDriver.
msedge.userDataDir	string	Ruta de acceso a la carpeta de datos de usuario usada por la instancia de Microsoft Edge.