title: "Encontrando Elementos Web"

Um dos aspectos mais fundamentais do uso do Selenium é obter referências de elementos para trabalhar.

O Selenium oferece várias [estratégias de localizador]({{< ref "locators.md" >}}) para identificar exclusivamente um elemento.

Há muitas maneiras de usar os localizadores em cenários complexos. Para os propósitos desta documentação,

vamos considerar este trecho de HTML:

<li class="tomatoes"><span>O tomate é um vegetal</span>…

<li class="tomatoes"><span>O tomate é uma fruta</span>…

Muitos localizadores irão corresponder a vários elementos na página.

O método de elemento de localização singular retornará uma referência ao

primeiro elemento encontrado dentro de um determinado contexto.

Quando o metodo find element é chamado na instância do driver, ele

retorna uma referência ao primeiro elemento no DOM que corresponde ao localizador fornecido.

Esse valor pode ser guardado e usado para ações futuras do elemento. Em nosso exemplo HTML acima, existem

dois elementos que têm um nome de classe de "tomatoes" então este método retornará o elemento na lista "vegetables".

Ao em vez de tentar encontrar um localizador unico no DOM inteiro, normalmente é útil restringir a busca ao escopo de outro elemento

já localizado. No exemplo acima existem dois elementos com um nome de classe de "tomatoes" e

é um pouco mais desafiador obter a referência para o segundo.

Uma possível solução seria localizar um elemento com um atributo único que seja um ancestral do elemento desejado e não um

ancestral do elemento indesejado, então invoque o find element nesse objeto:

**Java e C#**<br>

As classes `WebDriver`, `WebElement` e `ShadowRoot` todas implementam o `SearchContext` interface, que é

considerada uma _role-based interface_(interface baseada em função). As interfaces baseadas em função permitem determinar se uma determinada

implementação de driver suporta um recurso específico. Essas interfaces são claramente definidas e tentam

aderir a ter apenas um único papel de responsabilidade.

Uma pesquisa aninhada pode não ser a estratégia de localização mais eficaz, pois requer dois

comandos separados a serem emitidos para o navegador.

Para melhorar um pouco o desempenho, podemos usar CSS ou XPath para encontrar esse elemento com um único comando.

Veja as [sugestões de estratégia do localizador]({{< ref "/documentation/test_practices/encouraged/locators" >}}) na nossa sessão de

[Práticas de teste incentivadas]({{< ref "/documentation/test_practices/encouraged" >}}).

Para esse exemplo, utilizaremos o CSS Selector:

Existem vários casos de uso para a necessidade de obter referências a todos os elementos que correspondem a um localizador, em vez

do que apenas o primeiro. Os métodos plurais find elements retornam uma coleção de referências de elementos.

Se não houver correspondências, uma lista vazia será retornada. Nesse caso,

referências a todos os itens da lista de frutas e vegetais serão devolvidas em uma coleção.

precisa iterar sobre a coleção e identificar o que você deseja.

# Navegar até a URL

# Obtém todos os elementos disponiveis com o nome da tag 'p'

// Navegar até a URL

// Obtém todos os elementos disponiveis com o nome da tag 'p'

# Navegar até a URL

# Obtém todos os elementos disponiveis com o nome da tag 'p'

// Navegar até a URL

// Obtém todos os elementos disponiveis com o nome da tag 'p'

// Obtém todos os elementos disponiveis com o nome da tag 'p'

Ele é usado para localizar a lista de WebElements filhos correspondentes dentro do contexto do elemento pai.

Para realizar isso, o WebElement pai é encadeado com o 'findElements' para acessar seus elementos filhos.

// Obtém o elemento com o nome da tag 'div'

// Obtém todos os elementos disponiveis com o nome da tag 'p'

# Obtém o elemento com o nome da tag 'div'

# Obtém todos os elementos disponíveis com o nome da tag 'p'

// Obtém o elemento com o nome da tag 'div'

// Obtém todos os elementos disponíveis com o nome da tag 'p'

# Navegar até a URL

# Obtém o elemento com o nome da tag 'div'

# Obtém todos os elementos disponíveis com o nome da tag 'p'

// Obtém o elemento com o nome da tag 'div'

// Obtém todos os elementos disponíveis com o nome da tag 'p'

// Obtém o elemento com o nome da tag 'div'

// Obtém todos os elementos disponíveis com o nome da tag 'p'

Ele é usado para rastrear (ou) encontrar um elemento DOM que tem o foco no contexto de navegação atual.

// Obter atributo do elemento atualmente ativo

# Obter atributo do elemento atualmente ativo

// Navegar até a URL

// Obter atributo do elemento atualmente ativo

# Obter atributo do elemento atualmente ativo

// Obter atributo do elemento atualmente ativo

// Obter atributo do elemento atualmente ativo