Selenium Helper

Este pacote fornece um conjunto de utilitários para facilitar a interação com o Selenium WebDriver, incluindo funcionalidades para esperar por elementos, enviar texto, clicar em elementos, selecionar opções e mover o cursor sobre elementos.

Instalação

Você pode instalar o pacote diretamente do PyPI usando pip:

pip install trsolucoes

Uso

Aqui estão alguns exemplos de como usar as funções fornecidas pelo pacote.

Funções Principais

Importar pacotes

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

driver = webdriver.Chrome()
sh = SeleniumHelper(driver)

find_element

Aguarda a presença de um elemento na página e retorna o próprio elemento ou um booleano indicando se o elemento foi encontrado.

locator = (By.ID, 'example-id')
element_found = sh.find_element(locator, return_element=True)

write_element

Aguarda a presença de um elemento e envia um texto para ele, com opções para limpar o campo e clicar no elemento antes de enviar o texto.

locator = (By.NAME, 'example-name')
sh.write_element(locator, 'example text', clear_form=True)

click_element

Aguarda a presença de um elemento e clica nele.

locator = (By.XPATH, '//button[@class="example-class"]')
sh.click_element(locator)

select_element

Aguarda a presença de um elemento select e seleciona uma opção pelo texto visível.

locator = (By.TAG_NAME, 'select')
tag_filter = [('ng-reflect-name', 'labelOption'), ('ngcontent-c2', 'xp789e687')]
sh.select_element(locator, 'Option Text', tag_filter=tag_filter)

click_in_text_element

Aguarda um breve período e clica em um elemento cujo texto corresponde ao texto fornecido.

locator = (By.TAG_NAME, 'button')
sh.click_in_text_element(locator, 'Button Text')

hover_element

Aguarda a presença de um elemento e passa o cursor do mouse sobre ele.

locator = (By.CLASS_NAME, 'hover-target')
sh.hover_element(locator)