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 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 linguagem que normalmente têm métodos convenientes 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 os recursos, consulte a documentação da sua estrutura de teste WebDriver preferida. Para obter mais informações, consulte Escolher uma estrutura de teste do WebDriver.

Usando a classe EdgeOptions

Crie uma instância de , que fornece métodos de conveniência para definir recursos específicos do EdgeOptionsMicrosoft 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 da funcionalidade e um valor com o tipo correto. Para obter a lista completa de recursos e tipos de valor aceitos, consulte o objeto EdgeOptions.

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

Capacidades reconhecidas

Para recursos padrão que EdgeDriver aceitam, consulte a documentação do Selenium e o padrão W3C WebDriver. Este artigo lista apenas os recursos específicos do Microsoft Edge.

Objeto EdgeOptions

A maioria dos recursos específicos do Microsoft Edge é exposta por meio do EdgeOptions objeto. Em alguns idiomas, as funcionalidades são implementadas pela EdgeOptions classe. Em outros idiomas, os recursos são armazenados no ms:edgeOptions dicionário no DesiredCapabilitiesformato .

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 na inicialização. 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 .
binary string 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 string Um endereço de um servidor depurador ao qual se conectar, na forma de hostname/ip:port, por exemplo 127.0.0.1:38947.
detach booliano Valor padrão = false. Em caso falsede dúvida, o Microsoft Edge será encerrado quando o serviço WebDriver for desligado, mesmo que a extremidade local do WebDriver não tenha fechado a sessão. Se true, o Microsoft Edge só será encerrado se o fim local do WebDriver fechar a sessão. Se truee a extremidade local do WebDriver não fechar a sessão, EdgeDriver ele não limpa a pasta de dados do usuário temporária usada pela instância do Microsoft Edge.
excludeSwitches Lista de cadeias de caracteres Lista de opções de linha de comando do Microsoft Edge para excluir que o EdgeDriver por padrão passa ao iniciar o Microsoft Edge. Evite o prefixo -- para switches.
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 compactada codificada em base 64 (.crx).
localState Dicionário Um dicionário com cada entrada que consiste no nome da preferência e no valor. As preferências são aplicadas ao arquivo de Estado Local na pasta de dados do usuário.
minidumpPath string Diretório para armazenar minidespejos 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 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 no valor. As preferências são aplicadas apenas 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 string Um endereço de um servidor do Portal de Dispositivos do Windows ao qual se conectar, na forma de hostname/ip:port, por exemplo 127.0.0.1:50080. Para obter mais informações, consulte Depurar remotamente dispositivos Windows.
wdpPassword string Senha opcional a ser usada ao se conectar a um servidor do Portal de Dispositivos do Windows. Obrigatório se o servidor tiver a autenticação habilitada.
wdpUsername string Nome de usuário opcional a ser usado ao se conectar a um servidor do Portal de Dispositivos do Windows. Obrigatório se o servidor tiver a autenticação habilitada.
wdpProcessId inteiro A ID do processo necessária a ser usada ao anexar a um aplicativo WebView2 UWP em execução, por exemplo 36590. Esta informação pode ser encontrada 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 o objeto webviewOptions.
windowsApp string ID do modelo de usuário do aplicativo ID de um pacote de aplicativo do Microsoft Edge a ser iniciado, por exemplo Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE. Use windowsApp em vez de ao se conectar a um dispositivo ou emulador do Windows 10X usando o Portal de binary Dispositivos do Windows.
windowTypes Lista de cadeias de caracteres Uma lista de tipos de janela que são exibidos na lista de identificadores de janela. Para acessar elementos do modo de exibição da Web do Android, 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 do buffer de rastreamento do DevTools. Por exemplo, se for 1000, uma vez por segundo, o DevTools relatará o quão cheio está 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 de Rede.
enablePage booliano verdadeiro Para coletar (ou não coletar) eventos do domínio da página.
traceCategories string (vazio) Uma cadeia de caracteres separada por vírgula 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. 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 uma versão fixa do WebView2 runtime a ser usada. 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 temporária de dados 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 na inicialização. Os argumentos com um valor associado devem ser separados por um = sinal (por exemplo, ['start-maximized', 'log-level=0']).
releaseChannelPreference string Distribuição preferencial de WebView2 evergreen runtime 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 retorna 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.
  • Last updated on