Funcionalidades y EdgeOptions

Artículo
04/04/2023

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 `false`es , Microsoft Edge se cierra cuando se cierra el servicio WebDriver, incluso si el extremo local de WebDriver no ha cerrado la sesión. Si `true`es , 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.