Recursos e EdgeOptions

Artigo
04/04/2023

Recursos são opções que você pode usar para personalizar e configurar uma EdgeDriver sessão. Para saber mais sobre como iniciar uma nova EdgeDriver sessão, consulte Automatizando o Microsoft Edge. Este artigo descreve todos os recursos com suporte para o Microsoft Edge e fornece detalhes sobre como passar os recursos para EdgeDriver as sessões.

Os recursos são passados para uma sessão do WebDriver como um mapa JSON, mas não é necessário ou recomendado defini-los dessa forma. As estruturas de teste do WebDriver (como o Selenium) fornecem associações de idioma que normalmente têm métodos de conveniência para que você não precise configurar o mapa JSON por conta própria. Por exemplo, o Selenium configura recursos por meio da EdgeOptions classe.

Para saber mais sobre como configurar recursos, consulte a documentação da estrutura de teste do WebDriver preferencial. Para obter mais informações, confira Escolher uma estrutura de teste do WebDriver.

Usando a classe EdgeOptions

Crie uma instância do EdgeOptions, que fornece métodos de conveniência para definir recursos específicos do Microsoft Edge. Depois de configurar o EdgeOptions objeto, passe EdgeOptions para o EdgeDriver construtor.

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

Para usar recursos que não têm um método de conveniência associado, use o AddAdditionalEdgeOption método. Você deve passar o nome completo do recurso e um valor com o tipo correto. Para obter a lista completa de recursos aceitos e tipos de valor, consulte Objeto EdgeOptions.

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

Recursos reconhecidos

Para obter recursos padrão que EdgeDriver aceitem, consulte Documentação do Selenium e o padrão W3C WebDriver. Este artigo lista apenas recursos específicos do Microsoft Edge.

Objeto EdgeOptions

A maioria dos recursos específicos do Microsoft Edge são expostos por meio do EdgeOptions objeto. Em alguns idiomas, os recursos são implementados pela EdgeOptions classe. Em outros idiomas, os recursos são armazenados no ms:edgeOptions dicionário em DesiredCapabilities.

Recursos	Tipo	Detalhes
`args`	lista de cadeias de caracteres	Lista de argumentos de linha de comando a serem passados para o processo do Microsoft Edge no início. Os argumentos com um valor associado devem ser separados por um `=` sinal (por exemplo, `['start-maximized', 'user-data-dir=/tmp/temp_profile']`). Se você estiver iniciando um aplicativo WebView2, esses argumentos serão passados para seu aplicativo em vez do processo subjacente do navegador Microsoft Edge. Para passar argumentos para o processo do navegador ao iniciar um aplicativo WebView2, use WebviewOptions.additionalBrowserArguments em vez disso.
`binary`	cadeia de caracteres	Caminho para o binário do Microsoft Edge a ser usado (no macOS, o caminho deve ser o binário real, não apenas o aplicativo, por exemplo, `/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`).
`debuggerAddress`	cadeia de caracteres	Um endereço de um servidor de depurador ao qual se conectar, na forma de `hostname/ip:port`, por exemplo `127.0.0.1:38947`.
`detach`	booliano	Valor padrão = `false`. Se `false`, o Microsoft Edge sairá quando o serviço WebDriver for desligado, mesmo que o final local do WebDriver não tenha fechado a sessão. Se `true`, o Microsoft Edge só sairá se o final local do WebDriver fechar a sessão. Se `true`, e o final local do WebDriver não fechar a sessão, `EdgeDriver` não limpo a pasta de dados de usuário temporária usada pela instância do Microsoft Edge.
`excludeSwitches`	lista de cadeias de caracteres	A lista de opções de linha de comando do Microsoft Edge para excluir o EdgeDriver por padrão passa ao iniciar o Microsoft Edge. Evite o `--` prefixo para comutadores.
`extensions`	lista de cadeias de caracteres	Uma lista de extensões a serem instaladas na inicialização. Cada item na lista deve ser uma extensão empacotada codificada base-64 (`.crx`).
`localState`	Dicionário	Um dicionário com cada entrada que consiste no nome da preferência e do valor. As preferências são aplicadas ao arquivo Estado Local na pasta de dados do usuário.
`minidumpPath`	string	Diretório para armazenar minidumps do Microsoft Edge. (Com suporte apenas no Linux.)
`mobileEmulation`	Dicionário	Um dicionário com um valor para `deviceName`, ou valores para `deviceMetrics` e `userAgent`.
`perfLoggingPrefs`	Dicionário	Um dicionário opcional que especifica as preferências de registro em log de desempenho. Para obter mais informações, consulte objeto perfLoggingPrefs.
`prefs`	Dicionário	Um dicionário com cada entrada que consiste no nome da preferência e do valor. As preferências são aplicadas somente ao perfil de usuário em uso. Para obter exemplos, consulte o `Preferences` arquivo na pasta de dados do usuário do Microsoft Edge.
`wdpAddress`	cadeia de caracteres	Um endereço de um servidor do Windows Device Portal para se conectar, na forma de `hostname/ip:port`, por exemplo `127.0.0.1:50080`. Para obter mais informações, consulte Depuração Remota – Windows 10 dispositivos.
`wdpPassword`	string	Senha opcional a ser usada ao se conectar a um servidor do Windows Device Portal. Necessário se o servidor tiver a autenticação habilitada.
`wdpUsername`	cadeia de caracteres	Nome de usuário opcional a ser usado ao se conectar a um servidor do Windows Device Portal. Necessário se o servidor tiver a autenticação habilitada.
`wdpProcessId`	inteiro	A ID do processo necessária a ser usada se anexar a um aplicativo UWP do WebView2 em execução, por exemplo `36590`. Essas informações podem ser encontradas em `browserProcessIdhttp://<Device Portal URL>/msedge`.
`webviewOptions`	Dicionário	Um dicionário opcional que pode ser usado para configurar o ambiente WebView2 ao iniciar um aplicativo WebView2. Para obter mais informações, consulte objeto WebviewOptions.
`windowsApp`	cadeia de caracteres	ID do modelo de usuário do aplicativo de um pacote de aplicativo do Microsoft Edge a ser iniciado, por exemplo `Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE`. Use `windowsApp` em vez de `binary` ao se conectar a um dispositivo Windows 10X ou emulador usando o Windows Device Portal.
`windowTypes`	lista de cadeias de caracteres	Uma lista de tipos de janela exibidos na lista de identificadores de janela. Para acesso aos elementos do Android Webview, inclua `webview` na lista.

objeto perfLoggingPrefs

O perfLoggingPrefs dicionário tem o seguinte formato. Todas as chaves são opcionais.

Chave	Tipo	Valor padrão	Detalhes
`bufferUsageReportingInterval`	inteiro positivo	1000	O número solicitado de milissegundos entre eventos de uso de buffer de rastreamento de DevTools. Por exemplo, se 1000, uma vez por segundo, DevTools relatará o quão completo é o buffer de rastreamento. Se um relatório indicar que o uso do buffer é de 100%, um aviso será emitido.
`enableNetwork`	booliano	verdadeiro	Para coletar (ou não coletar) eventos do domínio Rede.
`enablePage`	booliano	verdadeiro	Para coletar (ou não coletar) eventos do domínio Página.
`traceCategories`	cadeia de caracteres	(vazio)	Uma cadeia de caracteres separada por vírgulas das categorias de rastreamento do Microsoft Edge para as quais os eventos de rastreamento devem ser coletados. Uma cadeia de caracteres não especificada ou vazia desabilita o rastreamento.

Objeto WebviewOptions

O webviewOptions dicionário é usado para configurar o ambiente WebView2 ao iniciar um aplicativo WebView2. Ele tem o seguinte formato. Todas as chaves são opcionais.

Chave	Tipo	Valor padrão	Detalhes
`browserExecutableFolder`	string	(vazio)	Caminho para uma pasta que contém um runtime WebView2 de versão fixa a ser usado. Para obter mais informações sobre como usar uma distribuição de runtime de versão fixa com o WebView2, consulte Distribuir um aplicativo WebView2 e o WebView2 Runtime.
`userDataFolder`	string	(vazio)	Caminho para a pasta de dados do usuário que o WebView2 usará. Se `userDataFolder` não for especificado, o Microsoft Edge WebDriver criará uma pasta de dados temporária do usuário. Para obter mais informações sobre como gerenciar a pasta de dados do usuário com o WebView2, consulte Gerenciar a pasta de dados do usuário.
`additionalBrowserArguments`	lista de cadeias de caracteres		Lista de argumentos de linha de comando que o WebView2 passará para o processo do navegador no início. Os argumentos com um valor associado devem ser separados por um `=` sinal (por exemplo, `['start-maximized', 'log-level=0']`).
`releaseChannelPreference`	string		Distribuição de runtime evergreen do WebView2 preferencial a ser usada. Pode ser `"stable"` ou `"canary"`.

Recursos retornados

A lista a seguir contém todos os recursos específicos do Microsoft Edge que EdgeDriver retornam quando você cria uma nova sessão.

Recursos	Tipo	Detalhes
`msedge.msedgedriverVersion`	string	A versão do EdgeDriver.
`msedge.userDataDir`	string	O caminho para a pasta de dados do usuário usada pela instância do Microsoft Edge.

Compartilhar via