Pular para o conteúdo

Automação: interação com a página

Comandos que clicam, preenchem, digitam, arrastam e leem estado de elementos por referência de snapshot.

Ver Markdown

Comandos, flags e valores são literais — não são traduzidos. Todos aceitam as flags de alvo --page/--node/--workspace descritas em Automação: navegação, e sem alvo agem na aba ativa do workspace atual.

A referência vem do snapshot

Os comandos por elemento usam --element <ref>, e esses ref vêm de elyra browser snapshot.

  • Tire o snapshot, use os ref na mesma página.
  • Depois de navegar ou de mudar a página, os ref antigos não valem mais — tire um snapshot novo.
  • A CLI recomenda, depois de cada ação, tirar um snapshot novo para conferir o que realmente assentou.

Ações por referência

Comando Uso
elyra browser click --element <ref> Clique
elyra browser dblclick --element <ref> Clique duplo
elyra browser hover --element <ref> Passar o mouse
elyra browser focus --element <ref> Dar foco
elyra browser fill --element <ref> --value <texto> Limpar e preencher
elyra browser type --input <texto> Digitar no foco atual
elyra browser select --element <ref> --value <valor> Escolher opção de lista
elyra browser check --element <ref> / elyra browser uncheck --element <ref> Marcar / desmarcar caixa ou rádio
elyra browser clear --element <ref> Limpar o conteúdo do campo
elyra browser select-all --element <ref> Selecionar todo o texto do campo
elyra browser keypress --key <nome> Pressionar tecla (Enter, Tab, Escape, ArrowDown…)
elyra browser drag --from <ref> --to <ref> Arrastar de um elemento para outro
elyra browser upload --element <ref> --files <caminho,...> Enviar arquivos locais para um campo de arquivo

Obrigatoriedades: fill e select exigem --value; drag exige --from e --to; upload exige --files; keypress exige --key. check e uncheck são o mesmo handler parametrizado.

clear apaga sem desfazer. upload envia arquivos do seu disco para a página — confira o que está indo e para onde.

Preencher vários campos de uma vez

elyra browser fill-form (--fields '<json>' | --fields-file <caminho>) [--page <id>] [--workspace <seletor>] [--json]
  • --fields é um vetor JSON no formato [{"element":"<ref>","value":"<texto>"}], com ref vindos de snapshot.
  • --fields e --fields-file são mutuamente exclusivos; informar os dois é erro.
  • Cada campo é reportado: o resultado diz o que entrou e o que falhou. Use elyra browser snapshot --json para conferir.
  • Um arquivo inválido ou vazio falha.

Ler estado e propriedade

Comando O que devolve
elyra browser get --what text|html|value|url|title|count|box [--element <ref>] Propriedade do elemento — ou da página, quando a propriedade é da página
elyra browser is --what visible|enabled|checked --element <ref> Estado do elemento
elyra browser find --locator <tipo> --value <texto> --action <ação> Localiza por locator semântico e executa a ação
elyra browser highlight --selector <ref> Destaca o elemento
elyra browser scrollintoview --element <ref> Rola até o elemento
elyra browser inserttext --text <texto> Insere texto sem eventos de tecla

inserttext não dispara keydown nem keyup. Páginas que reagem a eventos de tecla não se comportam como se você tivesse digitado — para esses casos, use digitação real.

Mouse de baixo nível

elyra browser mouse move --x <n> --y <n> [--page <id>] [--workspace <seletor>] [--json]
elyra browser mouse down [--button <left|right|middle>] [--page <id>] [--workspace <seletor>] [--json]
elyra browser mouse up [--button <left|right|middle>] [--page <id>] [--workspace <seletor>] [--json]
elyra browser mouse wheel --dy <n> [--dx <n>] [--page <id>] [--workspace <seletor>] [--json]
  • mouse move exige --x e --y; mouse wheel exige --dy, com --dx opcional.
  • As coordenadas são absolutas na página e dependem do viewport atual. Sem um snapshot recente, o alvo pode errar — em páginas com rolagem, o alvo muda sem aviso.