CodeGym /Cursos /Python SELF PT / Buscando elementos pelos atributos HTML: id, class ...

Buscando elementos pelos atributos HTML: id, class

Python SELF PT
Nível 35, Lição 3
Disponível

1. Fundamentos da busca de elementos

Métodos para buscar elementos

Antes de mergulhar de cabeça no código, é essencial entender como podemos buscar elementos numa página web com o Selenium. O Selenium oferece vários métodos práticos para encontrar elementos:

  • find_element_by_id(): Busca um elemento usando seu identificador único (id).
  • find_element_by_name(): Permite buscar um elemento através do atributo name.
  • find_element_by_class_name(): Busca elementos que possuem uma classe (class) específica.
  • find_element_by_tag_name(): Usa o nome da tag para encontrar elementos, como div, p, a.

Importante: esta é a sintaxe do Selenium 3. No Selenium 4 esses métodos foram removidos — o equivalente moderno com By está na próxima seção.

Vamos começar com um exemplo simples — buscando um elemento pelo id. Imagine que perdemos o botão com o texto "Botão Mágico" e precisamos encontrá-lo:

Python

from selenium import webdriver

# Configuração do driver e abertura do navegador
driver = webdriver.Chrome()
driver.get('https://example.com')

# Buscar o elemento pelo seu id
magic_button = driver.find_element_by_id('magic_button_id')

# Trabalhar com o elemento encontrado (por exemplo, extrair o texto)
print(magic_button.text)

# Finalização da sessão
driver.quit()

Trabalhando com elementos encontrados

Depois de encontrar um elemento, é hora de decidir o que fazer com ele. Solte a imaginação e use os métodos do Selenium, como text para pegar o conteúdo de texto do elemento ou get_attribute('attribute_name') para extrair o valor de qualquer atributo do elemento.

Suponha que o elemento seja um link, e queremos saber para onde ele aponta. É assim que fazemos:

Python

# Buscar o elemento com o link
link_element = driver.find_element_by_class_name('link_class')

# Extrair o URL do atributo href
link_url = link_element.get_attribute('href')
print(f'Este link aponta para: {link_url}')

2. Selenium 4: o formato moderno de busca com By

Tudo o que é descrito adiante nesta aula é a sintaxe clássica do Selenium 3. No Selenium 4 os métodos find_element_by_* foram primeiro marcados como obsoletos e, a partir da versão Selenium 4.3.0, removidos de vez. Se você rodar esse código em uma versão atual da biblioteca, vai receber um AttributeError.

No lugar do conjunto de métodos separados sobrou apenas um método universal, find_element(): o primeiro argumento é uma estratégia de busca da classe By e o segundo é o valor em si. A classe By precisa ser importada separadamente:

Python

from selenium.webdriver.common.by import By

Tabela de equivalência

Selenium 3 Selenium 4 O que faz
find_element_by_id('magic_button_id') find_element(By.ID, 'magic_button_id') Busca um elemento usando seu identificador único (id).
find_element_by_name('name') find_element(By.NAME, 'name') Permite buscar um elemento através do atributo name.
find_element_by_class_name('class') find_element(By.CLASS_NAME, 'class') Busca elementos que possuem uma classe (class) específica.
find_element_by_tag_name('tag') find_element(By.TAG_NAME, 'tag') Usa o nome da tag para encontrar elementos, como div, p, a.

A busca por todos os elementos correspondentes mudou da mesma forma: no lugar do conjunto find_elements_by_*() agora existe um único find_elements() com as mesmas estratégias de By. Além das quatro citadas, a classe By ainda oferece By.XPATH, By.CSS_SELECTOR, By.LINK_TEXT e By.PARTIAL_LINK_TEXT — falaremos delas nas próximas aulas.

O mesmo exemplo, mas no Selenium 4

Python

from selenium import webdriver
from selenium.webdriver.common.by import By

# Configuração do driver e abertura do navegador
driver = webdriver.Chrome()
driver.get('https://example.com')

# Buscar o elemento pelo seu id
magic_button = driver.find_element(By.ID, 'magic_button_id')

# Trabalhar com o elemento encontrado (por exemplo, extrair o texto)
print(magic_button.text)

# Finalização da sessão
driver.quit()

Como você vê, mudou apenas a linha da busca: todo o resto funciona exatamente igual, o método devolve o mesmo objeto de elemento com os mesmos text, get_attribute(), click() e send_keys().

Adiante na aula cada método é apresentado na forma clássica find_element_by_* — é assim que você vai encontrá-lo em código antigo e em parte dos exercícios. Para levar qualquer um deles ao Selenium 4, basta uma substituição mecânica pela tabela acima.

3. Método find_element_by_id()

O método find_element_by_id() é uma das maneiras mais rápidas e confiáveis para buscar um elemento na página. Ele localiza elementos pelo atributo único id. Em HTML, o atributo id é um identificador único, por isso podemos ter certeza de que o método retornará apenas o elemento necessário.

Exemplo de uso:

Python

element = driver.find_element_by_id("submit-button")

Neste exemplo, o Selenium busca o elemento com id="submit-button" e o armazena na variável element. Esse método é prático para buscar botões, formulários, campos de entrada e outros elementos únicos que raramente se repetem numa página.

Quando usar?

Usar find_element_by_id() é recomendado sempre que o elemento possuir um identificador único id, já que o método garante acesso rápido e preciso ao elemento.

4. Método find_element_by_name()

O método find_element_by_name() busca elementos pelo atributo name. Ele é frequentemente usado para formulários e campos de entrada, especialmente quando vários elementos podem ter a mesma classe ou id, mas diferentes valores para o atributo name. Ao contrário de id, o atributo name não precisa ser único, e às vezes há vários elementos com o mesmo name na página.

Exemplo de uso:

Python

element = driver.find_element_by_name("username")

Esse código busca o elemento com name="username". Normalmente é o campo de entrada do nome de usuário nos formulários de login.

Quando usar?

Esse método é útil se o elemento na página não possui um id único, mas tem o atributo name. Ele é especialmente eficiente para formulários de entrada, onde os elementos frequentemente são identificados por name.

5. Aplicações práticas

Agora sabemos como buscar elementos por id, classe e nome. Essa habilidade é super útil, especialmente para automatizar interações com páginas web. Os elementos encontrados podem ser usados para preencher formulários, clicar em botões ou extrair informações — tarefas que podem acelerar muito o seu trabalho e te livrar de tarefas repetitivas.

Imagine uma empresa onde cada funcionário gasta 10 minutos por dia preenchendo o mesmo formulário online. É aí que entra o Selenium: ele pode lidar com toda essa rotina em alguns minutos enquanto você toma seu café da manhã.

1
Tarefa
Python SELF PT, nível 35, lição 3
Bloqueado
Encontrar um elemento pelo identificador único
Encontrar um elemento pelo identificador único
2
Tarefa
Python SELF PT, nível 35, lição 3
Bloqueado
Busca e extração de URL de um elemento por classe
Busca e extração de URL de um elemento por classe
3
Tarefa
Python SELF PT, nível 35, lição 3
Bloqueado
Procura e interação com o botão
Procura e interação com o botão
4
Tarefa
Python SELF PT, nível 35, lição 3
Bloqueado
Busca de elementos e trabalho com eles dentro de uma tabela
Busca de elementos e trabalho com eles dentro de uma tabela
Comentários
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION