Navegador Web

Automação de navegador com Playwright

Abrir Navegador

web.open_browser

Inicia uma nova instância do navegador

Como usar

Abre o navegador e guarda a página na variável (por padrão {page}), que os demais comandos Web usam. Chromium é baixado pelo próprio Studio; Chrome e Edge usam os instalados no Windows. Na execução local o navegador fica aberto ao terminar e é reaproveitado na próxima execução, o que agiliza os testes; em produção ele sempre fecha. Use uma pasta de perfil para manter logins e cookies entre execuções.

Exemplo: Abra o Edge em modo normal, com a pasta de perfil C:\Robos\perfil-portal, para o login do portal ficar salvo.

Campos

Campo	Tipo	Padrão	Detalhes
Navegador *	Opção	`Chromium (incluso no A4A)`	Chrome e Edge usam o navegador instalado no computador (também precisa estar instalado na máquina do Runner)Opções: Chromium (incluso no A4A), Google Chrome (instalado), Microsoft Edge (instalado), Firefox, WebKit (Safari)
Modo Oculto	Sim/Não	`Não`	Executar sem janela visível do navegador
Pasta de perfil	Pasta		Pasta de dados do navegador: cookies, logins e extensões ficam guardados entre execuções. Vazio = sessão limpa. A pasta não pode estar aberta em outra janela do mesmo navegador.
Argumentos do navegador	Lista		Um por item (+ Adicionar item). Ex.: --kiosk-printing (imprime direto na impressora padrão, sem diálogo), --start-maximized, --disable-notifications, --lang=pt-BR
Salvar página na variável *	Variável de saída	`page`

+ Avançado (5)

Campo	Tipo	Padrão	Detalhes
Manter aberto ao terminar (execução local)	Sim/Não	`Sim`	No Bot Developer o navegador continua aberto, com página e sessão, quando o robô termina ou é parado, e o próximo "Abrir Navegador" o reaproveita. Fecha com "Fechar Navegador" ou quando você fecha a janela. Em produção (Runner) ele sempre fecha ao terminar.Só quando «Navegador» = «Chromium (incluso no A4A)» ou «Google Chrome (instalado)» ou «Microsoft Edge (instalado)» e «Modo Oculto» = «Não»
User Agent	Texto		String de user agent personalizada
Proxy	Texto		URL do servidor proxy (ex: http://proxy:8080)
Pasta de Download	Pasta		Diretório padrão para downloads
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

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

Navegar para URL

web.navigate

Navega para uma URL

Como usar

Abre um endereço na página. "Aguardar até" define quando o comando termina: load espera a página carregar por completo; domcontentloaded é mais rápido; networkidle espera a rede ficar parada, útil em sites que carregam dados depois.

Exemplo: Navegue para https://portal.fornecedor.com.br/pedidos e aguarde o carregamento completo.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
URL *	Texto	`https://`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Aguardar até	Opção	`load`	Opções: load, domcontentloaded, networkidle, commit
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

Clicar Elemento

web.click_element

Clica em um elemento da página

Como usar

Clica num elemento da página, esperando ele aparecer e ficar clicável até o tempo limite. Use "Inspecionar" no campo Seletor para capturar o elemento com o mouse; o Studio sugere os seletores mais estáveis (papel e nome, rótulo, ID). Para duplo clique, use 2 em "Quantidade de cliques".

Exemplo: Clique no botão "Entrar" (tipo Papel ARIA, seletor button|Entrar).

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Botão do mouse	Opção	`left`	Opções: left, right, middle
Quantidade de cliques	Número	`1`
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

Digitar Texto

web.type_text

Digita texto em um campo de input

Como usar

Preenche um campo de texto. Por padrão limpa o campo antes e preenche de uma vez; com um intervalo entre teclas, digita tecla por tecla, como uma pessoa, útil em campos com máscara ou busca automática. Para senhas, use uma credencial do cofre em vez de texto fixo.

Exemplo: Digite {cpf_cliente} no campo com rótulo "CPF" (tipo Rótulo do campo).

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor
Texto *	Texto
Limpar campo antes	Sim/Não	`Sim`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Intervalo entre teclas	Número	`0 ms`
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

Obter Texto

web.get_text

Obtém o texto de um elemento

Como usar

Lê o texto visível de um elemento e guarda numa variável. Bom para capturar mensagens, status, totais e números de protocolo exibidos na tela.

Exemplo: Leia o texto do elemento com ID "numero-protocolo" e guarde em {protocolo}.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor
Salvar resultado na variável *	Variável de saída	`text`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

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

Obter Atributo

web.get_attribute

Obtém atributo de um elemento

Como usar

Lê um atributo HTML de um elemento, como href de um link, value de um campo, src de uma imagem ou um data-*. Use quando a informação não aparece como texto na tela.

Exemplo: Leia o atributo href do link "Baixar boleto" para obter o endereço do PDF.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor
Atributo *	Texto	`href`
Salvar resultado na variável *	Variável de saída	`attribute_value`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

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

Aguardar Elemento

web.wait_element

Espera até que o elemento apareça

Como usar

Espera um elemento chegar ao estado escolhido: aparecer (visible), existir na página mesmo oculto (attached), sumir (hidden) ou ser removido (detached). Use antes de interagir com telas que demoram, ou para esperar um "Carregando..." desaparecer.

Exemplo: Aguarde o elemento com texto "Processando" ficar oculto antes de ler o resultado.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor
Estado	Opção	`visible`	Opções: visible, attached, hidden, detached

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

Aguardar Navegação

web.wait_navigation

Espera o carregamento da página

Como usar

Espera a página terminar de carregar depois de uma ação que muda de página, como enviar um formulário. Normalmente os comandos já esperam sozinhos; use este quando o site navega de forma lenta ou por redirecionamentos.

Exemplo: Depois de clicar em "Emitir", aguarde a navegação até o estado networkidle.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Estado de carregamento	Opção	`load`	Opções: load, domcontentloaded, networkidle

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`	Espera máxima em milissegundos

Selecionar Opção

web.select_option

Seleciona opção em um dropdown <select>

Como usar

Escolhe uma opção numa lista suspensa (<select>), pelo texto exibido (label), pelo valor interno (value) ou pela posição (index, começando em 0). Para listas que não são <select> (componentes personalizados), clique na lista e depois na opção.

Exemplo: Selecione "São Paulo" na lista com rótulo "Estado", selecionando por label.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor		Ex.: `#id, .classe ou //xpath`
Opção *	Texto
Selecionar por	Opção	`Texto visível`	Opções: Texto visível, Valor, Índice

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Marcar/Desmarcar

web.check_checkbox

Marca/desmarca checkbox ou radio

Como usar

Marca ou desmarca uma caixa de seleção ou opção (radio). Com "Marcado" ligado, garante que fique marcada; desligado, desmarcada. Não inverte se já estiver no estado pedido.

Exemplo: Marque a caixa "Li e aceito os termos" antes de enviar o cadastro.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor		Ex.: `#id, .classe ou //xpath`
Marcado	Sim/Não	`Sim`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Enviar Arquivo

web.upload_file

Faz upload de arquivo em input type=file

Como usar

Anexa um arquivo num campo de envio (<input type="file">) sem abrir a janela do Windows. Informe o seletor do campo de arquivo e o caminho; o arquivo precisa existir na máquina onde o robô roda.

Exemplo: Envie {caminho_nota_pdf} no campo "Anexar nota fiscal".

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor do campo de arquivo *	Seletor		Ex.: `#id, .classe ou //xpath`
Arquivo *	Arquivo

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Baixar Arquivo

web.download_file

Aguarda e captura download

Como usar

Clica no elemento que inicia o download, espera o arquivo chegar e o salva na pasta indicada com o nome sugerido pelo site. O caminho completo do arquivo baixado fica na variável, pronto para os próximos comandos (ler, mover, enviar por e-mail).

Exemplo: Clique em "Exportar CSV", salve em C:\Robos\entrada e use {downloaded_file} para ler o arquivo.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Elemento que inicia o download *	Seletor		Ex.: `#id, .classe ou //xpath`
Salvar na pasta *	Pasta
Salvar caminho do arquivo na variável *	Variável de saída	`downloaded_file`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`120000 ms`

Resultado: guardado na variável downloaded_file (Caminho de arquivo).

Capturar Tela

web.screenshot

Captura screenshot da página inteira

Como usar

Salva uma imagem PNG da página. Com "Página inteira", inclui a parte que só aparece rolando. Útil como evidência de execução ou para investigar erros.

Exemplo: Capture a tela em C:\Robos\evidencias\pedido_{numero}.png após confirmar o pedido.

Campos

Campo	Tipo	Padrão
Variável da página *	Variável	`page`
Salvar imagem como *	Arquivo
Página inteira	Sim/Não	`Sim`

Capturar Elemento

web.screenshot_element

Captura screenshot de um elemento

Como usar

Salva uma imagem PNG só de um elemento, como um comprovante, um gráfico ou uma mensagem de erro.

Exemplo: Capture o quadro do comprovante (seletor #comprovante) em {pasta_evidencias}\comprovante.png.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor		Ex.: `#id, .classe ou //xpath`
Salvar imagem como *	Arquivo

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Executar JavaScript

web.execute_js

Executa código JS no contexto da página

Como usar

Executa JavaScript na página e guarda o resultado. Uma expressão simples (document.title) é avaliada direto; com return, o script vira o corpo de uma função. Use para ler dados que nenhum outro comando alcança ou acionar funções do próprio site.

Exemplo: Execute return document.querySelectorAll('tr.pedido').length; para contar os pedidos da tabela.

Campos

Campo	Tipo	Padrão
Variável da página *	Variável	`page`
Script *	Código	`return document.title;`
Salvar resultado na variável *	Variável de saída	`js_result`

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

Obter Código Fonte

web.get_page_source

Retorna o HTML da página

Como usar

Guarda o HTML atual da página numa variável, já com o conteúdo gerado por JavaScript. Útil para extrair dados com os comandos de Web Scraping ou salvar para análise.

Exemplo: Obtenha o código fonte em {html} e extraia os preços com o comando de Web Scraping.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Salvar resultado na variável *	Variável de saída	`html`

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

Alternar Aba

web.switch_tab

Alterna para outra aba do navegador

Como usar

Passa a trabalhar em outra aba do navegador, localizada pela posição, por parte do título ou por parte do endereço, e guarda essa aba na variável. Use quando um clique abre o conteúdo numa aba nova.

Exemplo: Depois de clicar em "Abrir boleto", alterne para a aba cujo endereço contém "boleto" e guarde em {page}.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Localizar aba por	Opção	`Posição`	Opções: Posição, Título contém, URL contém
Posição da aba (0 = primeira)	Número	`0`	Só quando «Localizar aba por» = «Posição»
Texto *	Texto		Só quando «Localizar aba por» = «Título contém» ou «URL contém»
Salvar aba na variável *	Variável de saída	`page`

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

Nova Aba

web.new_tab

Abre uma nova aba

Como usar

Abre uma aba nova no mesmo navegador (mesma sessão e cookies) e guarda na variável. A aba original continua disponível na variável dela.

Exemplo: Abra uma nova aba em https://consulta.receita.gov.br guardando em {aba_consulta} enquanto mantém o sistema aberto em {page}.

Campos

Campo	Tipo	Padrão
Variável da página *	Variável	`page`
URL	Texto	`about:blank`
Salvar nova aba na variável *	Variável de saída	`new_page`

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

Fechar Aba

web.close_tab

Fecha a aba atual

Como usar

Fecha a aba da variável. O navegador continua aberto com as outras abas; depois, use a variável de outra aba (ou Alternar Aba).

Exemplo: Feche {aba_consulta} depois de copiar o resultado e volte a usar {page}.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`

Fechar Navegador

web.close_browser

Encerra o navegador

Como usar

Fecha o navegador e todas as abas. Ao fim do robô os navegadores abertos também são fechados (exceto o mantido aberto na execução local); use este comando para liberar a memória antes de etapas longas.

Exemplo: Feche o navegador depois de baixar os relatórios e antes de processar as planilhas.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`

Definir Viewport

web.set_viewport

Define tamanho da janela

Como usar

Muda o tamanho da área visível da página, em pixels. Alguns sites mudam o layout conforme a largura; fixe o tamanho para o robô sempre ver a mesma versão.

Exemplo: Defina 1920 × 1080 para o sistema exibir o menu completo em vez do menu de celular.

Campos

Campo	Tipo	Padrão
Variável da página *	Variável	`page`
Largura *	Número	`1366 px`
Altura *	Número	`768 px`

Tratar Diálogo

web.handle_dialog

Aceita/rejeita alert/confirm/prompt

Como usar

Prepara a resposta para o próximo alerta, confirmação ou prompt do site: aceitar ou cancelar, e o texto para o prompt. Coloque este comando ANTES da ação que abre o diálogo. A mensagem exibida fica na variável.

Exemplo: Antes de clicar em "Excluir", trate o diálogo aceitando a confirmação "Deseja mesmo excluir?".

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Ação *	Opção	`Aceitar`	Opções: Aceitar, Rejeitar
Texto para prompt()	Texto		Só quando «Ação» = «Aceitar»
Salvar mensagem do diálogo na variável *	Variável de saída	`dialog_message`

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

Hover no Elemento

web.hover_element

Move o mouse sobre o elemento

Como usar

Passa o mouse sobre um elemento sem clicar. Necessário em menus que só abrem no hover e em dicas (tooltips).

Exemplo: Passe o mouse sobre o menu "Relatórios" e depois clique em "Vendas do mês".

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor *	Seletor		Ex.: `#id, .classe ou //xpath`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Pressionar Tecla

web.press_key

Pressiona uma tecla ou atalho (Enter, Tab, Control+A) no elemento ou na página

Como usar

Pressiona uma tecla ou atalho (Enter, Tab, Escape, Control+A, ArrowDown...) num elemento, ou na página se o seletor ficar vazio. Útil para confirmar buscas com Enter ou navegar por listas com as setas.

Exemplo: Pressione Enter no campo de busca depois de digitar {codigo_produto}.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tecla *	Texto	`Enter`	Nomes do Playwright: Enter, Tab, Escape, ArrowDown, F5, Control+A, Shift+TabEx.: `Enter`
Tipo de seletor	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor	Seletor		Vazio = o elemento que está com o focoEx.: `#id, .classe ou //xpath`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Arrastar e Soltar

web.drag_and_drop

Arrasta um elemento para outro

Como usar

Arrasta um elemento e solta sobre outro, como em quadros Kanban, listas reordenáveis ou áreas de upload por arrastar.

Exemplo: Arraste o cartão "Pedido 1234" para a coluna "Concluído".

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo do seletor de origem *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Elemento a arrastar *	Seletor
Tipo do seletor de destino *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Destino *	Seletor

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Rolar até

web.scroll_to

Rola a página até um elemento ou posição

Como usar

Rola a página até um elemento, até o topo ou até o fim. Útil em páginas que carregam mais itens ao rolar (rolagem infinita) e antes de capturar telas.

Exemplo: Role até o fim da página para o site carregar a próxima leva de produtos.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Rolar até	Opção	`Elemento`	Opções: Elemento, Topo da página, Fim da página
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)Só quando «Rolar até» = «Elemento»
Seletor *	Seletor		Só quando «Rolar até» = «Elemento»

Obter Cookies

web.get_cookies

Retorna os cookies da sessão

Como usar

Lê os cookies da sessão do navegador como uma lista. Útil para reaproveitar a sessão em chamadas REST ao mesmo site.

Exemplo: Obtenha os cookies em {cookies} depois do login e use o de sessão no cabeçalho de uma chamada à API do portal.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Salvar resultado na variável *	Variável de saída	`cookies`

Resultado: guardado na variável cookies (Lista).

Definir Cookie

web.set_cookie

Define um cookie

Como usar

Cria ou altera um cookie no navegador, para o domínio e caminho informados. Use para aceitar avisos de cookies, definir preferências ou reaproveitar uma sessão.

Exemplo: Defina o cookie aceite_lgpd = sim no domínio portal.empresa.com.br para o aviso não aparecer.

Campos

Campo	Tipo	Padrão
Variável da página *	Variável	`page`
Nome *	Texto
Valor *	Texto
Domínio *	Texto

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Caminho	Texto	`/`
Seguro (HTTPS)	Sim/Não	`Sim`

Limpar Cookies

web.clear_cookies

Remove todos os cookies

Como usar

Remove todos os cookies do navegador, encerrando sessões e preferências salvas. Útil para trocar de usuário sem fechar o navegador.

Exemplo: Limpe os cookies antes de entrar no portal com o próximo usuário da lista.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`

Preencher Formulário

web.fill_form

Preenche múltiplos campos de um formulário

Como usar

Preenche vários campos de uma vez: cada linha liga um seletor ao valor a digitar. Mais rápido de montar do que vários Digitar Texto em formulários grandes.

Exemplo: #nome → {nome}, #email → {email}, #telefone → {telefone} no formulário de cadastro.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Campos (seletor → valor) *	Pares chave e valor

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tempo limite	Número	`30000 ms`

Extrair Tabela

web.extract_table

Extrai dados de uma tabela HTML para DataFrame

Como usar

Lê uma tabela HTML (<table>) e guarda como tabela de dados (DataFrame), com a primeira linha como cabeçalho se marcado. Depois use os comandos de Dados para filtrar, ou o Para Cada para percorrer as linhas, ou salve em Excel.

Exemplo: Extraia a tabela #lista-pedidos em {pedidos} e salve no Excel com o comando de Dados.

Campos

Campo	Tipo	Padrão	Detalhes
Variável da página *	Variável	`page`
Tipo de seletor *	Opção	`Automático (CSS ou XPath)`	Como localizar o elemento. Ex.: ID → cpf; Texto → Entrar; Papel → button\|Salvar; XPath → //button[@type='submit']Opções: Automático (CSS ou XPath), CSS, XPath, ID, Atributo name, Classe CSS, Tag HTML, Texto (contém), Texto exato, Texto do link, Papel ARIA (papel\|nome), Rótulo do campo (label), Placeholder, Texto alternativo (imagens), Título (tooltip), Test ID (data-testid)
Seletor da tabela *	Seletor	`table`
Primeira linha é cabeçalho	Sim/Não	`Sim`
Salvar resultado na variável *	Variável de saída	`table`

Resultado: guardado na variável table (Tabela (DataFrame)).