Web — Selenium (Legado)

Automação de navegador com Selenium WebDriver

Abrir Navegador (Selenium)

web_selenium.open_browser

Inicia Chrome/Firefox/Edge via Selenium

Como usar

Abre o Chrome, Edge ou Firefox pelo Selenium e guarda o navegador na variável (por padrão {driver}), usada pelos demais comandos deste módulo. O driver certo é baixado sozinho. Para robôs novos, prefira o módulo Navegador Web (Playwright), mais rápido e com Inspetor e Gravador; use o Selenium quando um robô antigo ou um site exigir.

Exemplo: Abra o Chrome maximizado guardando em {driver} para acessar o sistema legado de compras.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador	Opção	`Chrome`	Opções: Chrome, Edge, Firefox
Oculto (headless)	Sim/Não	`Não`
Salvar o navegador na variável *	Variável de saída	`driver`

+ Avançado (5)

Campo	Tipo	Padrão
Maximizar a janela	Sim/Não	`Sim`
Pasta do perfil	Pasta
Pasta de downloads	Pasta
Argumentos do navegador	Lista
Tempo limite de carregamento	Número	`60 s`

Resultado: guardado na variável driver (Objeto).

Navegar

web_selenium.navigate

Navega para URL

Como usar

Abre o endereço no navegador do Selenium e espera a página carregar (até o tempo limite definido ao abrir o navegador).

Exemplo: Navegue o {driver} para https://compras.empresa.local/login.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
URL *	Texto

Buscar Elemento

web_selenium.find_element

Encontra elemento por seletor

Como usar

Localiza um elemento (ou todos os que casarem, como lista) e guarda na variável, esperando até o tempo informado. Os seletores são os mesmos da Web: CSS, XPath, ID, nome, texto e outros.

Exemplo: Busque todas as linhas "table#itens tr" como lista em {linhas} para percorrer com Para Cada.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor *	Seletor
Todos os que casarem (lista)	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`element`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`30 s`

Resultado: guardado na variável element (Qualquer).

Clicar

web_selenium.click

Clica em um elemento

Como usar

Espera o elemento ficar clicável e clica. Se outro elemento estiver por cima (um aviso, por exemplo), o clique é refeito por JavaScript; marque "Clicar por JavaScript" para usar sempre esse modo.

Exemplo: Clique no botão com ID "btnPesquisar".

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor *	Seletor

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`30 s`
Clicar por JavaScript	Sim/Não	`Não`

Enviar Teclas

web_selenium.send_keys

Digita texto ou teclas especiais

Como usar

Digita um texto no campo, limpando antes se marcado, e pode pressionar Enter no fim. Para senhas, use uma credencial do cofre.

Exemplo: Digite {numero_pedido} no campo de nome "pedido" e pressione Enter.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor *	Seletor
Texto *	Texto
Limpar o campo antes	Sim/Não	`Sim`
Pressionar Enter no fim	Sim/Não	`Não`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`30 s`

Obter Texto

web_selenium.get_text

Retorna texto do elemento

Como usar

Lê o texto visível do elemento e guarda numa variável.

Exemplo: Leia o texto de "span.status" em {status_pedido}.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor *	Seletor
Salvar resultado na variável *	Variável de saída	`text`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`30 s`

Resultado: guardado na variável text (Texto).

Aguardar Elemento

web_selenium.wait_element

WebDriverWait com expected conditions

Como usar

Espera o elemento ficar visível, clicável, presente ou invisível. Pode guardar o resultado (verdadeiro/falso) e, com "Falhar o robô" desmarcado, seguir mesmo se o tempo acabar, para você decidir com um Se.

Exemplo: Aguarde até 60 s o "#mensagem-sucesso" ficar visível, guardando em {salvou} sem falhar o robô.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor *	Seletor
Até o elemento estar	Opção	`Visível`	Opções: Visível, Clicável, Na página, Sumido/invisível
Esperar até	Número	`30 s`
Salvar o resultado (verdadeiro/falso) na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Falhar o robô se o tempo esgotar	Sim/Não	`Sim`

Resultado: guardado na variável escolhida (Booleano).

Executar Script

web_selenium.execute_script

Executa JavaScript via driver

Como usar

Executa JavaScript no navegador. Use return no script para devolver um valor; os argumentos ficam em arguments[0], arguments[1]...

Exemplo: Execute return document.title; e guarde em {titulo}.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
JavaScript *	Código		Use return para devolver um valor; arguments[0], arguments[1]... são os argumentos
Salvar o resultado na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Argumentos	Lista

Resultado: guardado na variável escolhida (Qualquer).

Alternar Frame

web_selenium.switch_frame

Alterna para iframe

Como usar

Entra num iframe (por seletor ou posição) para os comandos seguintes enxergarem os elementos dele; "parent" volta um nível e "default" volta para a página principal.

Exemplo: Entre no iframe "#frame-boleto", leia o código de barras e volte para a página principal com "default".

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Ir para	Opção	`Frame pelo seletor`	Opções: Frame pelo seletor, Frame pela posição, Frame pai, Página principal
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exatoSó quando «Ir para» = «Frame pelo seletor»
Seletor *	Seletor		Só quando «Ir para» = «Frame pelo seletor»
Posição (o primeiro é 0)	Número	`0`	Só quando «Ir para» = «Frame pela posição»

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`30 s`

Alternar Janela

web_selenium.switch_window

Alterna entre janelas/abas

Como usar

Passa para outra janela ou aba: a última aberta, por posição, por parte do título ou por parte do endereço.

Exemplo: Depois de clicar em "Imprimir 2ª via", alterne para a última janela aberta.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`
Ir para	Opção	`Última aba aberta`	Opções: Última aba aberta, Aba pela posição (a primeira é 0), Aba cujo título contém, Aba cuja URL contém
Posição, título ou URL	Texto		Só quando «Ir para» = «Aba pela posição (a primeira é 0)» ou «Aba cujo título contém» ou «Aba cuja URL contém»
Salvar o título da aba na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Esperar até	Número	`10 s`

Resultado: guardado na variável escolhida (Texto).

Capturar Tela

web_selenium.screenshot

Screenshot do navegador

Como usar

Salva um PNG da janela do navegador ou, com seletor, só de um elemento.

Exemplo: Capture a tela em {pasta_evidencias}\erro.png quando o cadastro falhar.

Campos

Campo	Tipo	Padrão
Navegador *	Variável	`driver`
Arquivo PNG *	Arquivo
Salvar o caminho na variável	Variável de saída

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Opções: Automático (CSS ou XPath), CSS, XPath, ID, Name, Classe, Tag, Texto do link, Parte do texto do link, Contém o texto, Texto exato
Seletor	Seletor
Esperar até	Número	`30 s`

Resultado: guardado na variável escolhida (Texto).

Fechar Navegador

web_selenium.close_browser

Encerra o WebDriver

Como usar

Fecha o navegador e encerra o driver do Selenium. O robô também fecha ao terminar.

Exemplo: Feche o {driver} ao concluir o lote de pedidos.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Variável	`driver`