Selenium

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to browsing context commands.

Open a new window

Creates a new browsing context in a new window.

Selenium v4.8

Browsing Context

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

This section contains the APIs related to input commands.

Perform Actions

Selenium v4.17

Design patterns and development strategies

Mon, 01 Jan 0001 00:00:00 +0000

(previously located: https://github.com/SeleniumHQ/selenium/wiki/Bot-Style-Tests)

Overview

Over time, projects tend to accumulate large numbers of tests. As the total number of tests increases, it becomes harder to make changes to the codebase — a single “simple” change may cause numerous tests to fail, even though the application still works properly. Sometimes these problems are unavoidable, but when they do occur you want to be up and running again as quickly as possible. The following design patterns and strategies have been used before with WebDriver to help make tests easier to write and maintain. They may help you too.

WebDriver BiDi Logging Features

Mon, 01 Jan 0001 00:00:00 +0000

Remember that to use WebDriver BiDi, you must enable it in Options. For more details, see Enabling BiDi

Console Message Handlers

Record or take actions on console.log events.

Add Handler

Implementation Missing

Browser navigation

Mon, 01 Jan 0001 00:00:00 +0000

Navegar para

A primeira coisa que você vai querer fazer depois de iniciar um navegador é abrir o seu site. Isso pode ser feito em uma única linha, utilize o seguinte comando:

 //Convenient
 driver.get("https://selenium.dev");
 
 //Longer way
 driver.navigate().to("https://selenium.dev");

View Complete Code View on GitHub

driver.get("https://www.selenium.dev/selenium/web/index.html")

View Complete Code View on GitHub

 //Convenient
 driver.Url = "https://selenium.dev";
 //Longer
 driver.Navigate().GoToUrl("https://selenium.dev");

View Complete Code View on GitHub


 it 'navigates to a page' do
 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Convenient
 await driver.get('https://www.selenium.dev');

 //Longer way
 await driver.navigate().to("https://www.selenium.dev/selenium/web/index.html");

View Complete Code View on GitHub

//Convenient
driver.get("https://selenium.dev")

//Longer way
driver.navigate().to("https://selenium.dev")

Voltar

Pressionando o botão Voltar do navegador:

 //Back
 driver.navigate().back();

View Complete Code View on GitHub

driver.back()

View Complete Code View on GitHub

 //Back
  driver.Navigate().Back();

View Complete Code View on GitHub

 driver.navigate.to 'https://www.selenium.dev/'

View Complete Code View on GitHub

 //Back
 await driver.navigate().back();

View Complete Code View on GitHub

driver.navigate().back()

WebDriver BiDi Network Features

Mon, 01 Jan 0001 00:00:00 +0000

The implementation of these features is being tracked here: #13993

Remember that to use WebDriver BiDi, you must enable it in Options. For more details, see Enabling BiDi

Authentication Handlers

Authentication handlers enable you to intercept authentication requests that occur during a network interaction. These handlers are useful for automating scenarios involving authentication prompts, such as Basic Auth or Digest Auth. They allow you to programmatically provide credentials or modify the authentication flow.

Network

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to network commands.

Add network intercept

Selenium v4.18

Script

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

Commands

This section contains the APIs related to script commands.

Call function in a browsing context

Selenium v4.15

Interacting with web elements

Mon, 01 Jan 0001 00:00:00 +0000

There are only 5 basic commands that can be executed on an element:

click (applies to any element)
send keys (only applies to text fields and keyboard interactable elements)
clear (only applies to text fields and content editable elements)
submit (only applies to form elements)
select (see Select List Elements)

Additional validations

These methods are designed to closely emulate a user’s experience, so, unlike the Actions API, it attempts to perform two things before attempting the specified action.

Internet Explorer Driver Internals

Mon, 01 Jan 0001 00:00:00 +0000

Client Code Into the Driver

We use the W3C WebDriver protocol to communicate with a local instance of an HTTP server. This greatly simplifies the implementation of the language-specific code, and minimizes the number of entry points into the C++ DLL that must be called using a native-code interop technology such as JNA, ctypes, pinvoke or DL.

Memory Management

The IE driver utilizes the Active Template Library (ATL) to take advantage of its implementation of smart pointers to COM objects. This makes reference counting and cleanup of COM objects much easier.

Command Listeners

Mon, 01 Jan 0001 00:00:00 +0000

These allow you to execute custom actions in every time specific Selenium commands are sent

Add Example

Chrome DevTools Logging Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Console Logs

 ((HasLogEvents) driver).onLogEvent(consoleEvent(e -> messages.add(e.getMessages().get(0))));

View Complete Code View on GitHub

 async with driver.bidi_connection() as session:
 async with Log(driver, session).add_listener(Console.ALL) as messages:

View Complete Code View on GitHub

 using IJavaScriptEngine monitor = new JavaScriptEngine(driver);
 var messages = new List<string>();
 monitor.JavaScriptConsoleApiCalled += (_, e) =>
 {
 messages.Add(e.MessageContent);
 };
 await monitor.StartEventMonitoring();

View Complete Code View on GitHub

 driver.on_log_event(:console) { |log| logs << log.args.first }

View Complete Code View on GitHub

Implementation Missing

Opções CLI

Mon, 01 Jan 0001 00:00:00 +0000

Diferentes secções estão disponíveis para configurar uma Grid. Cada secção tem opções que podem ser configuradas através de opções CLI.

Pode ver abaixo um mapeamento entre o componente e a secção respectiva.

Note que esta documentação pode estar desactualizada se uma opção foi adicionada ou modificada, mas ainda não ter havido oportunidade de actualizar a documentação. Caso depare com esta situação, verifique a secção “ajuda de configuração” e esteja à vontade para nos enviar um pull request com alterações a esta página.

Gerenciador do Selenium (Beta)

Mon, 01 Jan 0001 00:00:00 +0000

Motivation

TL;DR: Selenium Manager is the official driver manager of the Selenium project, and it is shipped out of the box with every Selenium release.

Selenium uses the native support implemented by each browser to carry out the automation process. For this reason, Selenium users need to place a component called driver (chromedriver, geckodriver, msedgedriver, etc.) between the script using the Selenium API and the browser. For many years, managing these drivers was a manual process for Selenium users. This way, they had to download the required driver for a browser (chromedriver for Chrome, geckodriver for Firefox, etc.) and place it in the PATH or export the driver path as a system property (Java, JavaScript, etc.). But this process was cumbersome and led to maintainability issues.

Configuração do Cliente HTTP

Mon, 01 Jan 0001 00:00:00 +0000

These allow you to set various parameters for the HTTP library

package dev.selenium.drivers;

import dev.selenium.BaseTest;

import org.openqa.selenium.remote.http.ClientConfig;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.chrome.ChromeOptions;
import org.openqa.selenium.remote.RemoteWebDriver;

import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManager;
import javax.net.ssl.TrustManagerFactory;
import javax.net.ssl.X509TrustManager;
import java.io.FileInputStream;
import java.net.URL;
import java.nio.file.Path;
import java.security.KeyStore;
import java.security.cert.CertificateFactory;
import java.security.cert.X509Certificate;
import java.time.Duration;

import org.openqa.selenium.UsernameAndPassword;

import static java.net.http.HttpClient.Version.HTTP_1_1;

public class HttpClientTest extends BaseTest {
 URL gridUrl;

 @BeforeEach
 public void startGrid() {
 gridUrl = startStandaloneGridAdvanced();
 }

 @Test
 public void remoteWebDriverWithClientConfig() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverIgnoreSSL() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createIgnoreSSLContext())
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .authenticateAs(new UsernameAndPassword("admin", "myStrongPassword"))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(gridUrl)
 .config(clientConfig)
 .build();
 }

 @Test
 public void remoteWebDriverWithEmbedAuthUrl() throws Exception {
 ClientConfig clientConfig = ClientConfig.defaultConfig()
 .withRetries()
 .sslContext(createSSLContextWithCA(Path.of("src/test/resources/tls.crt").toAbsolutePath().toString()))
 .connectionTimeout(Duration.ofSeconds(300))
 .readTimeout(Duration.ofSeconds(3600))
 .version(HTTP_1_1.toString());
 ChromeOptions options = getDefaultChromeOptions();
 options.setEnableDownloads(true);
 driver = RemoteWebDriver.builder()
 .oneOf(options)
 .address(embedAuthToUrl(gridUrl, "admin", "myStrongPassword"))
 .config(clientConfig)
 .build();
 }

 private URL embedAuthToUrl(URL url, String username, String password) throws Exception {
 String userInfo = username + ":" + password;
 String urlWithAuth = url.getProtocol() + "://" + userInfo + "@" + url.getHost() + ":" + url.getPort() + url.getPath();
 return new URL(urlWithAuth);
 }

 public static SSLContext createSSLContextWithCA(String caCertPath) throws Exception {
 FileInputStream fis = new FileInputStream(caCertPath);
 CertificateFactory cf = CertificateFactory.getInstance("X.509");
 X509Certificate caCert = (X509Certificate) cf.generateCertificate(fis);
 KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
 keyStore.load(null, null);
 keyStore.setCertificateEntry("caCert", caCert);
 TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
 tmf.init(keyStore);
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, tmf.getTrustManagers(), null);
 return sslContext;
 }

 public static SSLContext createIgnoreSSLContext() throws Exception {
 TrustManager[] trustAllCerts = new TrustManager[]{
 new X509TrustManager() {
 public X509Certificate[] getAcceptedIssuers() {
 return null;
 }

 public void checkClientTrusted(X509Certificate[] certs, String authType) {
 }

 public void checkServerTrusted(X509Certificate[] certs, String authType) {
 }
 }
 };
 SSLContext sslContext = SSLContext.getInstance("TLS");
 sslContext.init(null, trustAllCerts, new java.security.SecureRandom());
 return sslContext;
 }
}

View on GitHub

import os
import pytest
import sys
from urllib3.util import Retry, Timeout
from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy
from selenium.webdriver.common.proxy import ProxyType
from selenium.webdriver.remote.client_config import ClientConfig


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_with_client_config(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 retries = Retry(connect=2, read=2, redirect=2)
 timeout = Timeout(connect=300, read=3600)
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 init_args_for_pool_manager={
 "init_args_for_pool_manager": {"retries": retries, "timeout": timeout}},
 ca_certs=_get_resource_path("tls.crt"),
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


@pytest.mark.skipif(sys.platform == "win32", reason="Gets stuck on Windows, passes locally")
def test_start_remote_ignore_certs(grid_server):
 proxy = Proxy({"proxyType": ProxyType.AUTODETECT})
 client_config = ClientConfig(remote_server_addr=grid_server,
 proxy=proxy,
 timeout=3600,
 ignore_certificates=True,
 username="admin", password="myStrongPassword")
 options = get_default_chrome_options()
 driver = webdriver.Remote(command_executor=grid_server, options=options, client_config=client_config)
 driver.get("https://www.selenium.dev")
 driver.quit()


def _get_resource_path(file_name: str):
 if os.path.abspath("").endswith("tests"):
 path = os.path.abspath(f"resources/{file_name}")
 else:
 path = os.path.abspath(f"tests/resources/{file_name}")
 return path

def get_default_chrome_options():
 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 return options

View on GitHub

Add Example

Classe de Serviço do Driver

Mon, 01 Jan 0001 00:00:00 +0000

The Service classes are for managing the starting and stopping of drivers. They can not be used with a Remote WebDriver session.

Service classes allow you to specify information about the driver, like location and which port to use. They also let you specify what arguments get passed to the command line. Most of the useful arguments are related to logging.

Default Service instance

To start a driver with a default service instance:

Toml Options

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

All the options shown in CLI options can be configured through a TOML file. This page shows configuration examples for the different Grid components.

Note that this documentation could be outdated if an option was modified or added but has not been documented yet. In case you bump into this situation, please check the “Config help” section and feel free to send us a pull request updating this page.

Funcionalidade específica do Chrome

Mon, 01 Jan 0001 00:00:00 +0000

Por omissão, Selenium 4 é compatível com Chrome v75 e superiores. Note que a versão (maior) do navegador e do chromedriver devem ser idênticas.

Opções

Capacidades comuns a todos os navegadores estão descritas na página Opções.

Capacidades únicas ao Chrome podem ser encontradas na página da Google para Capacidades e & ChromeOptions

Este é um exemplo de como iniciar uma sessão Chrome com um conjunto de opções básicas:

 ChromeOptions options = getDefaultChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = webdriver.ChromeOptions()
 options.add_argument("--no-sandbox")
 driver = webdriver.Chrome(options=options)

View Complete Code View on GitHub

 var options = new ChromeOptions();
 driver = new ChromeDriver(options);

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.chrome
 @driver = Selenium::WebDriver.for :chrome, options: options

View Complete Code View on GitHub

 const Options = new Chrome.Options();
 let driver = new Builder()
 .forBrowser(Browser.CHROME)
 .setChromeOptions(Options)
 .build();

View Complete Code View on GitHub

Add Example

Information about web elements

Mon, 01 Jan 0001 00:00:00 +0000

There are a number of details you can query about a specific element.

Is Displayed

This method is used to check if the connected Element is displayed on a webpage. Returns a Boolean value, True if the connected element is displayed in the current browsing context else returns false.

This functionality is mentioned in, but not defined by the w3c specification due to the impossibility of covering all potential conditions. As such, Selenium cannot expect drivers to implement this functionality directly, and now relies on executing a large JavaScript function directly. This function makes many approximations about an element’s nature and relationship in the tree to return a value.

Localizando elementos

Mon, 01 Jan 0001 00:00:00 +0000

Um localizador é uma forma de identificar elementos numa página. São os argumentos passados aos métodos Finders .

Visite os nossas directrizes e recomendações para dicas sobre locators, incluindo quais usar e quando, e também porque é que deve declarar localizadores separadamente dos finders.

Estratégias de seleção de elemento

Existem oito estratégias diferentes de localização de elementos embutidas no WebDriver:

Localizador	Descrição
class name	Localiza elementos cujo nome de classe contém o valor de pesquisa (nomes de classes compostas não são permitidos)
css selector	Localiza elementos que correspondem a um seletor CSS
id	Localiza elementos cujo atributo de ID corresponde ao valor de pesquisa
name	Localiza elementos cujo atributo NAME corresponde ao valor de pesquisa
link text	Localiza elementos âncora cujo texto visível corresponde ao valor de pesquisa
partial link text	Localiza elementos âncora cujo texto visível contém o valor da pesquisa. Se vários elementos forem correspondentes, apenas o primeiro será selecionado.
tag name	Localiza elementos cujo nome de tag corresponde ao valor de pesquisa
xpath	Localiza elementos que correspondem a uma expressão XPath

Creating Locators

To work on a web element using Selenium, we need to first locate it on the web page. Selenium provides us above mentioned ways, using which we can locate element on the page. To understand and create locator we will use the following HTML snippet.

Logging Selenium commands

Mon, 01 Jan 0001 00:00:00 +0000

Turning on logging is a valuable way to get extra information that might help you determine why you might be having a problem.

Getting a logger

Java logs are typically created per class. You can work with the default logger to work with all loggers. To filter out specific classes, see Filtering

Chrome DevTools Network Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Basic authentication

Some applications make use of browser authentication to secure pages. It used to be common to handle them in the URL, but browsers stopped supporting this. With this code you can insert the credentials into the header when necessary

Personalizando um Nó

Mon, 01 Jan 0001 00:00:00 +0000

Como personalizar um Nó

Há momentos em que gostaríamos de personalizar um Nó de acordo com nossas necessidades.

Por exemplo, podemos desejar fazer alguma configuração adicional antes que uma sessão comece a ser executada e executar alguma limpeza após o término de uma sessão.

Os seguintes passos podem ser seguidos para isso:

Crie uma classe que estenda org.openqa.selenium.grid.node.Node.
Adicione um método estático (este será nosso método de fábrica) à classe recém-criada, cuja assinatura se parece com esta:

Ações de Caneta

Mon, 01 Jan 0001 00:00:00 +0000

Chromium Only

Uma caneta é um tipo de entrada de ponteiro que possui a maior parte do mesmo comportamento que um mouse, mas também pode ter propriedades de evento únicas para uma caneta stylus. Além disso, enquanto um mouse possui 5 botões, uma caneta possui 3 estados equivalentes de botão:

0 — Contato por Toque (o padrão; equivalente a um clique com o botão esquerdo)
2 — Botão do Barril (equivalente a um clique com o botão direito)
5 — Botão de Borracha (atualmente não suportado pelos drivers)

Usando uma Caneta

Selenium v4.2

Funcionalidade específica do Edge

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft Edge foi criado com recurso ao Chromium, cuja versão mais antiga suportada é a v79. Tal como o Chrome, a versão (maior) do edgedriver deve ser igual à do navegador Edge.

Todas as capacidades e opções encontradas na página Chrome page irão funcionar de igual forma para o Edge.

Opções

Capabilities common to all browsers are described on the Options page.

Capabilities unique to Chromium are documented at Google’s page for Capabilities & ChromeOptions

External datastore

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

Introduction

Selenium Grid allows you to persist information related to currently running sessions into an external data store. The external data store could be backed by your favourite database (or) Redis Cache system.

File Upload

Mon, 01 Jan 0001 00:00:00 +0000

Because Selenium cannot interact with the file upload dialog, it provides a way to upload files without opening the dialog. If the element is an input element with type file, you can use the send keys method to send the full path to the file that will be uploaded.

 WebElement fileInput = driver.findElement(By.cssSelector("input[type=file]"));
 fileInput.sendKeys(uploadFile.getAbsolutePath());
 driver.findElement(By.id("file-submit")).click();

View Complete Code View on GitHub

 file_input = driver.find_element(By.CSS_SELECTOR, "input[type='file']")
 file_input.send_keys(upload_file)
 driver.find_element(By.ID, "file-submit").click()

View Complete Code View on GitHub

 IWebElement fileInput = driver.FindElement(By.CssSelector("input[type=file]"));
 fileInput.SendKeys(uploadFile);
 driver.FindElement(By.Id("file-submit")).Click();

View Complete Code View on GitHub

 file_input = driver.find_element(css: 'input[type=file]')
 file_input.send_keys(upload_file)
 driver.find_element(id: 'file-submit').click

View Complete Code View on GitHub

 await driver.get('https://the-internet.herokuapp.com/upload');
 // Upload snapshot

View Complete Code View on GitHub

Move Code

Guia de estilo para a documentação do Selenium

Mon, 01 Jan 0001 00:00:00 +0000

Read our contributing documentation for complete instructions on how to add content to this documentation.

Alerts

Alerts have been added to direct potential contributors to where specific content is missing.

{{< alert-content />}}

{{< alert-content >}}
Additional information about what specific content is needed
{{< /alert-content >}}

Which gets displayed like this:

Content Help

Note: This section needs additional and/or updated content

Additional information about what specific content is needed

Check our contribution guidelines if you’d like to help.

Funcionalidade específica do Firefox

Mon, 01 Jan 0001 00:00:00 +0000

Por omissão, Selenium 4 é compatível com Firefox 78 ou superior. Recomendamos que use sempre a versão mais recente do geckodriver.

Opções

Capacidades comuns a todos os navegadores estão descritas na página Opções.

Capacidades únicas ao Firefox podem ser encontradas na página da Mozilla para firefoxOptions

Este é um exemplo de como iniciar uma sessão Firefox com um conjunto de opções básicas:

 driver = new FirefoxDriver(options);
 }

View Complete Code View on GitHub

 options = webdriver.FirefoxOptions()
 driver = webdriver.Firefox(options=options)

View Complete Code View on GitHub

 public void BasicOptions()
 {

View Complete Code View on GitHub

 options = Selenium::WebDriver::Options.firefox
 @driver = Selenium::WebDriver.for :firefox, options: options

View Complete Code View on GitHub

 driver = new Builder()
 .forBrowser(Browser.FIREFOX)
 .setFirefoxOptions(options)
 .build();

View Complete Code View on GitHub

Add Example

Working with IFrames and frames

Mon, 01 Jan 0001 00:00:00 +0000

Frames são um meio obsoleto de construir um layout de site a partir de vários documentos no mesmo domínio. É improvável que você trabalhe com eles a menos que você esteja trabalhando com um webapp pré-HTML5. Iframes permitem a inserção de um documento de um domínio totalmente diferente, e são ainda comumente usado.

Se você precisa trabalhar com frames ou iframes, o WebDriver permite que você trabalhe com eles da mesma maneira. Considere um botão dentro de um iframe. Se inspecionarmos o elemento usando as ferramentas de desenvolvimento do navegador, podemos ver o seguinte:

Ações de Roda de Rolagem

Mon, 01 Jan 0001 00:00:00 +0000

Selenium v4.2

Chromium Only

Existem 5 cenários para rolagem em uma página.

Rolagem até o Elemento

Este é o cenário mais comum. Diferentemente dos métodos tradicionais de clique e envio de teclas, a classe de ações não rolará automaticamente o elemento de destino para a visualização, portanto, este método precisará ser usado se os elementos não estiverem dentro da janela de visualização.

Chrome DevTools Script Features

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Japanese. Do you speak Japanese? Help us to translate it by sending us pull requests!

While Selenium 4 provides direct access to the Chrome DevTools Protocol, these methods will eventually be removed when WebDriver BiDi implemented.

Script Pinning

 ScriptKey key = ((JavascriptExecutor) driver).pin("return arguments;");
 List<Object> arguments =
 (List<Object>) ((JavascriptExecutor) driver).executeScript(key, 1, true, element);

View Complete Code View on GitHub

Implementation Missing

Funcionalidade específica do IE

Mon, 01 Jan 0001 00:00:00 +0000

Desde Junho de 2022, o Projecto Selenium deixou de suportar oficialmente o navegador Internet Explorer. O driver Internet Explorer continua a suportar a execução do Microsoft Edge no modo “IE Compatibility Mode.”

Considerações especiais

O IE Driver é o único driver mantido directamente pelo Projecto Selenium. Embora existam binários para as versões de 32 e 64 bits, existem algumas limitações conhecidas com o driver de 64 bits. Desta forma, recomenda-se a utilização do driver de 32 bits.

Tips on working with locators

Mon, 01 Jan 0001 00:00:00 +0000

Take a look at examples of the supported locator strategies.

No geral, se os IDs de HTML estiverem disponíveis, únicos e consistentemente previsíveis, eles são o método preferido para localizar um elemento uma página. Eles tendem a trabalhar muito rapidamente e dispensar muito processamento que vem com travessias de DOM complicadas.

Se IDs exclusivos não estiverem disponíveis, um seletor CSS bem escrito é o método preferido de localização de um elemento. XPath funciona bem como CSS seletores, mas a sintaxe é complicada e frequentemente difícil de depurar. Embora os seletores XPath sejam muito flexíveis, eles não são tipicamente testados em performance por fornecedores de navegadores e tendem a ser bastante lentos.

Programe o seu primeiro script Selenium

Mon, 01 Jan 0001 00:00:00 +0000

Assim que você tiver o Selenium instalado, você estará pronto para programar códigos Selenium.

Oito Componentes Básicos

Tudo que o Selenium faz é enviar comandos ao navegador de internet para fazer algo ou solicitar informações dele. A maior parte do que você irá fazer com o Selenium é uma combinação desses comandos básicos.

Click on the link to “View full example on GitHub” to see the code in context.

1. Iniciando uma sessão

Para ter mais detalhes sobre como iniciar uma sessão, leia nossa documentação em driver sessions

Working with windows and tabs

Mon, 01 Jan 0001 00:00:00 +0000

Janelas e guias

Pegue o idenficador da janela

O WebDriver não faz distinção entre janelas e guias. E se seu site abre uma nova guia ou janela, o Selenium permitirá que você trabalhe usando um identificador. Cada janela tem um identificador único que permanece persistente em uma única sessão. Você pode pegar o identificador atual usando:

 // Navigate to Url
 driver.get("https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html");
 //fetch handle of this
 String currHandle=driver.getWindowHandle();
 assertNotNull(currHandle);

View Complete Code View on GitHub

 driver.get(url)
 current_handle = driver.current_window_handle
 assert current_handle is not None

View Complete Code View on GitHub

 // Navigate to Url
  driver.Url="https://www.selenium.dev/selenium/web/window_switching_tests/page_with_frame.html";
  //fetch handle of this
  String currHandle = driver.CurrentWindowHandle;
  Assert.IsNotNull(currHandle);

View Complete Code View on GitHub

driver.window_handle

await driver.getWindowHandle();

driver.windowHandle

Alternando janelas ou guias

Clicar em um link que abre em uma nova janela focará a nova janela ou guia na tela, mas o WebDriver não saberá qual janela que o sistema operacional considera ativa. Para trabalhar com a nova janela você precisará mudar para ela. Se você tiver apenas duas guias ou janelas abertas, e você sabe com qual janela você iniciou, pelo processo de eliminação você pode percorrer as janelas ou guias que o WebDriver pode ver e alternar para aquela que não é o original.

Arquitectura da Grid

Mon, 01 Jan 0001 00:00:00 +0000

A Grid está desenhada como um conjunto de componentes, em que cada tem o seu papel crucial em manter a Grid. Isto pode parecer um pouco complicado, mas esperamos que este documento ajude a esclarecer alguma confusão.

Os componentes chave

Os componentes principais da Grid são:

Event Bus: Usado para enviar mensagens que podem ser recebidas de forma assíncrona entre os outros componentes.
New Session Queue: Mantém uma lista de pedidos de sessão que serão assignadas a um Node pelo Distributor.
Distributor: Responsável por manter um modelo das localizações da Grid (slots) onde uma sessão pode ser lançada e também por aceitar novos pedidos de sessão e assignar a um slot livre.
Node: Executa uma sessão WebDriver. Cada sessão é assignada a um slot e cada Node tem um ou mais slots.
Session Map: Mantém um mapeamento entre um ID de sessão e o endereço do Node onde a sessão está a ser executada.
Router: Este é o ponto de entrada da Grid. É também a única parte da Grid que poderá estar exposta à Internet (embora nós não recomendemos). Este componente reencaminha novos pedidos para New Session Queue ou para o Node onde a sessão esteja a ser executada

Ao falar da Grid, há alguns conceitos úteis a ter em mente:

Como atualizar para Selenium 4

Mon, 01 Jan 0001 00:00:00 +0000

Atualizar para o Selenium 4 deve ser um processo sem dificuldades se você estiver usando uma das linguagens oficialmente suportadas (Ruby, JavaScript, C#, Python, and Java). Pode haver alguns casos em que alguns problemas podem acontecer, este guia irá ajudar você a resolvê-los. Vamos passar as etapas para atualizar as dependências do seu projeto e entender as depreciações e também as mudanças trazidas pela versão atualizada.

Estas são as etapas que seguiremos para atualizar para o Selenium 4:

Selenium IDE

Mon, 01 Jan 0001 00:00:00 +0000

Selenium’s Integrated Development Environment (Selenium IDE) é uma ferramenta de utilização simples que grava as acções de um utilizador usando comandos Selenium com parametros definidos conforme o contexto de cada elemento. Esta é uma forma excelente de aprender todo o sintaxe Selenium. Está disponível para os navegadores Google Chrome, Mozilla Firefox, e Microsoft Edge.

Para mais informações, visite a Documentação Selenium IDE.

Funcionalidade específica do Safari

Mon, 01 Jan 0001 00:00:00 +0000

Ao invés dos drivers para Chromium e Firefox, o safaridriver faz parte to sistema Operativo. Para activar a automação no Safari, execute o seguinte comando no terminal:

safaridriver --enable

Opções

Capacidades comuns a todos os navegadores estão descritas na página Opções.

Capacidades únicas ao Safari podem ser encontradas na página da Apple WebDriver para Safari

Este é um exemplo de como iniciar uma sessão Safari com um conjunto de opções básicas::

 SafariOptions options = new SafariOptions();
 driver = new SafariDriver(options);

View Complete Code View on GitHub

 options = webdriver.SafariOptions()
 driver = webdriver.Safari(options=options)

View Complete Code View on GitHub

 var options = new SafariOptions();
 driver = new SafariDriver(options);

View Complete Code View on GitHub

 it 'basic options' do
 options = Selenium::WebDriver::Options.safari

View Complete Code View on GitHub

 let driver = new Builder()
 .forBrowser(Browser.SAFARI)
 .setSafariOptions(options)
 .build();

View Complete Code View on GitHub

val options = SafariOptions()
val driver = SafariDriver(options)

Mobile (celular)

Se pretende automatizar Safari em iOS, deve olhar para o Projecto Appium.

Organizando e executando o código Selenium

Mon, 01 Jan 0001 00:00:00 +0000

Se quiser executar mais do que um punhado de scripts pontuais, precisa de ser capaz de organizar e trabalhar com seu código. Esta página deve dar a você ideias de como fazer coisas produtivas com seu código Selenium.

Usos comuns

A maioria das pessoas usa o Selenium para executar testes automatizados para aplicações web, mas o Selenium suporta qualquer caso de uso de automação de navegador.

Tarefas Repetitivas

Talvez seja necessário fazer login em um site e baixar algo ou enviar um formulário. Você pode criar um script Selenium para ser executado com um serviço em horários pré-definidos.

BiDirectional API (W3C compliant)

Mon, 01 Jan 0001 00:00:00 +0000

Page being translated from English to Portuguese. Do you speak Portuguese? Help us to translate it by sending us pull requests!

This section contains the APIs related to logging.

Console logs

Listen to the console.log events and register callbacks to process the event.

Selenium v4.8

Virtual Authenticator

Mon, 01 Jan 0001 00:00:00 +0000

Aplicações web podem habilitar um mecanismo de autenticação baseado em chaves públicas conhecido como Web Authentication para autenticar usuários sem usar uma senha. Web Authentication define APIs que permitem ao usuário criar uma credencial e registra-la com um autenticador. Um autenticador pode ser um dispositivo ou um software que guarde as chaves públicas do usuário e as acesse caso seja pedido.

Como o nome sugere, Virtual Authenticator emula esses autenticadores para testes.

Mon, 01 Jan 0001 00:00:00 +0000

expected_conditions.ja.md— title: “Waiting with Expected Conditions” linkTitle: “Expected Conditions” weight: 1 description: > These are classes used to describe what needs to be waited for.

Expected Conditions are used with Explicit Waits. Instead of defining the block of code to be executed with a lambda, an expected conditions method can be created to represent common things that get waited on. Some methods take locators as arguments, others take elements as arguments.

Selenium

Browsing Context

Commands

Open a new window

Browsing Context

Perform Actions

Design patterns and development strategies

Overview

WebDriver BiDi Logging Features

Console Message Handlers

Add Handler

Browser navigation

Navegar para

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

Voltar

/examples/java/src/test/java/dev/selenium/interactions/NavigationTest.java

/examples/python/tests/interactions/test_navigation.py

/examples/dotnet/SeleniumDocs/Interactions/NavigationTest.cs

/examples/ruby/spec/interactions/navigation_spec.rb

/examples/javascript/test/interactions/navigation.spec.js

WebDriver BiDi Network Features

Authentication Handlers

Network

Commands

Add network intercept

Script

Commands

Call function in a browsing context

Interacting with web elements

Additional validations

Internet Explorer Driver Internals

Client Code Into the Driver

Memory Management

Command Listeners

Chrome DevTools Logging Features

Console Logs

/examples/java/src/test/java/dev/selenium/bidi/cdp/LoggingTest.java

/examples/python/tests/bidi/cdp/test_logs.py

/examples/dotnet/SeleniumDocs/BiDi/CDP/LoggingTest.cs

/examples/ruby/spec/bidi/cdp/logging_spec.rb

Opções CLI

Gerenciador do Selenium (Beta)

Motivation

Configuração do Cliente HTTP

Classe de Serviço do Driver

Default Service instance

Toml Options

Funcionalidade específica do Chrome

Opções

/examples/java/src/test/java/dev/selenium/browsers/ChromeTest.java

/examples/python/tests/browsers/test_chrome.py

/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs

/examples/ruby/spec/browsers/chrome_spec.rb

/examples/javascript/test/browser/chromeSpecificCaps.spec.js

Information about web elements

Is Displayed

Localizando elementos

Estratégias de seleção de elemento

Creating Locators

Logging Selenium commands

Getting a logger

Chrome DevTools Network Features

Basic authentication

Personalizando um Nó

Como personalizar um Nó

Ações de Caneta

Usando uma Caneta

Funcionalidade específica do Edge

Opções

External datastore

Table of Contents

Introduction

File Upload

/examples/java/src/test/java/dev/selenium/elements/FileUploadTest.java

/examples/python/tests/elements/test_file_upload.py

/examples/dotnet/SeleniumDocs/Elements/FileUploadTest.cs