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 atributoname. -
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, comodiv,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:
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:
# 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:
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
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:
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:
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ã.
GO TO FULL VERSION