Partilhar via


Recursos e EdgeOptions

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.