Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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. |