Partilhar via


Capacidades e EdgeOptions

As capacidades são opções que pode utilizar para personalizar e configurar uma EdgeDriver sessão. Para saber mais sobre como iniciar uma nova EdgeDriver sessão, consulte Automatizar o Microsoft Edge. Este artigo descreve todas as capacidades suportadas para o Microsoft Edge e fornece detalhes sobre como transmitir as capacidades para EdgeDriver sessões.

As capacidades são transmitidas para uma sessão do WebDriver como um mapa JSON, mas não é necessário nem recomendado defini-las desta forma. As arquiteturas de teste do WebDriver (como o Selenium) fornecem enlaces de linguagem que normalmente têm métodos de conveniência, pelo que não precisa de configurar o mapa JSON manualmente. Por exemplo, o Selenium configura as capacidades através da EdgeOptions classe .

Para saber mais sobre como configurar capacidades, consulte a documentação da sua arquitetura de teste do WebDriver preferida. Para obter mais informações, consulte Escolher uma arquitetura de teste do WebDriver.

Utilizar a classe EdgeOptions

Crie uma instância do EdgeOptions, que fornece métodos de conveniência para definir capacidades específicas 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 utilizar capacidades que não têm um método de conveniência associado, utilize o AddAdditionalEdgeOption método . Tem de transmitir o nome completo da capacidade e um valor com o tipo correto. Para obter a lista completa de capacidades aceites e tipos de valor, veja Objeto EdgeOptions.

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

Capacidades Reconhecidas

Para obter as capacidades padrão que EdgeDriver aceitam, consulte a documentação do Selenium e o W3C WebDriver standard. Este artigo lista apenas as capacidades específicas do Microsoft Edge.

Objeto EdgeOptions

A maioria das capacidades específicas do Microsoft Edge são expostas através do EdgeOptions objeto. Em alguns idiomas, as capacidades são implementadas pela EdgeOptions classe . Noutros idiomas, as capacidades são armazenadas no ms:edgeOptions dicionário em DesiredCapabilities.

Recursos Tipo Detalhes
args lista de cadeias Lista de argumentos da linha de comandos a transmitir para o processo do Microsoft Edge ao iniciar. Os argumentos com um valor associado devem ser separados por um = sinal (por exemplo, ['start-maximized', 'user-data-dir=/tmp/temp_profile']). Se estiver a iniciar uma aplicação WebView2, estes argumentos são transmitidos para a sua aplicação em vez do processo subjacente do browser Microsoft Edge. Para transmitir argumentos ao processo do browser ao iniciar uma aplicação WebView2, utilize webviewOptions.additionalBrowserArguments como alternativa.
binary string Caminho para o binário do Microsoft Edge a utilizar (no macOS, o caminho deve ser o binário real e não apenas a aplicação. Por exemplo, /Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge).
debuggerAddress string Um endereço de um servidor de depurador ao qual ligar, sob a forma de hostname/ip:port, por exemplo 127.0.0.1:38947.
detach booliano Valor predefinido = false. Se false, o Microsoft Edge é encerrado quando o serviço WebDriver é encerrado, mesmo que o fim local do WebDriver não tenha fechado a sessão. Se true, o Microsoft Edge só é encerrado se o ponto 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 utilizador temporária utilizada pela instância do Microsoft Edge.
excludeSwitches lista de cadeias Lista de parâmetros da linha de comandos do Microsoft Edge para excluir que o EdgeDriver passa por predefinição ao iniciar o Microsoft Edge. Evite o -- prefixo para comutadores.
extensions lista de cadeias Uma lista de extensões a instalar no arranque. Cada item na lista deve ser uma extensão com codificação 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 ficheiro Estado Local na pasta de dados do utilizador.
minidumpPath string Diretório para armazenar minidumps do Microsoft Edge. (Suportado 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 registo de desempenho. Para obter mais informações, veja perfLoggingPrefs object (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ó são aplicadas ao perfil de utilizador em utilização. Para obter exemplos, veja o Preferences ficheiro na pasta de dados do utilizador do Microsoft Edge.
wdpAddress string Um endereço de um servidor do Portal do Dispositivo Windows ao qual ligar, sob a forma de hostname/ip:port, por exemplo 127.0.0.1:50080. Para obter mais informações, consulte Depurar remotamente dispositivos Windows.
wdpPassword string Palavra-passe opcional a utilizar ao ligar a um servidor do Portal do Dispositivo Windows. Necessário se o servidor tiver a autenticação ativada.
wdpUsername string Nome de utilizador opcional a utilizar ao ligar a um servidor do Portal do Dispositivo Windows. Necessário se o servidor tiver a autenticação ativada.
wdpProcessId inteiro O ID de processo necessário a utilizar se estiver a anexar a uma aplicação WebView2 UWP em execução, por exemplo 36590. Estas informações podem ser encontradas em browserProcessIdhttp://<Device Portal URL>/msedge.
webviewOptions dicionário Um dicionário opcional que pode ser utilizado para configurar o ambiente WebView2 ao iniciar uma aplicação WebView2. Para obter mais informações, veja webviewOptions object (Objeto webviewOptions).
windowsApp string ID do modelo de utilizador da aplicação de um pacote de aplicações do Microsoft Edge para iniciar, por exemplo Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE. Utilize windowsApp em vez de ligar a um dispositivo Windows 10X ou emulador através do binary Portal do Dispositivo Windows.
windowTypes lista de cadeias Uma lista de tipos de janela que são apresentados na lista de alças de janela. Para aceder aos elementos do Webview 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 número inteiro positivo 1000 O número pedido de milissegundos entre eventos de utilização da memória intermédia de rastreio de DevTools. Por exemplo, se for 1000, uma vez por segundo, a DevTools comunica a totalidade da memória intermédia de rastreio. Se um relatório indicar que a utilização da memória intermédia é de 100%, é emitido um aviso.
enableNetwork booliano verdadeiro Para recolher (ou não recolher) eventos do Domínio de rede.
enablePage booliano verdadeiro Para recolher (ou não recolher) eventos do Domínio de página.
traceCategories string (vazio) Uma cadeia separada por vírgulas das categorias de rastreio do Microsoft Edge para as quais os eventos de rastreio devem ser recolhidos. Uma cadeia não especificada ou vazia desativa o rastreio.

objeto webviewOptions

O webviewOptions dicionário é utilizado para configurar o ambiente WebView2 ao iniciar uma aplicação 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 um runtime WebView2 de versão fixa a utilizar. Para obter mais informações sobre como utilizar uma distribuição de runtime de versão fixa com o WebView2, consulte Distribuir uma aplicação WebView2 e o WebView2 Runtime.
userDataFolder string (vazio) Caminho para a pasta de dados do utilizador que o WebView2 irá utilizar. Se userDataFolder não for especificado, o Microsoft Edge WebDriver criará uma pasta de dados de utilizador temporária. Para obter mais informações sobre como gerir a pasta de dados do utilizador com o WebView2, consulte Gerir a pasta de dados do utilizador.
additionalBrowserArguments lista de cadeias Lista de argumentos da linha de comandos que o WebView2 irá transmitir para o processo do browser ao iniciar. Os argumentos com um valor associado devem ser separados por um = sinal (por exemplo, ['start-maximized', 'log-level=0']).
releaseChannelPreference string WebView2 preferencial distribuição de runtime evergreen a utilizar. Pode ser "stable" ou "canary".

Capacidades devolvidas

A lista seguinte contém todas as capacidades específicas do Microsoft Edge que EdgeDriver são devolvidas quando 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 utilizador utilizada pela instância do Microsoft Edge.