Pular para o conteúdo principal
Roberty Studio
RPANavegador

Obter elemento

Obter elemento

Localiza e retorna um único elemento HTML na página do navegador a partir de um seletor CSS. O elemento obtido fica disponível para ser usado como entrada em outras ações do robô.

dica

Use a extensão Roberty Automation no navegador para capturar o seletor CSS do elemento desejado com um clique, sem precisar inspecionar o HTML manualmente.


Opções​

Selecione a ação​

Define a origem da busca.

Um elemento no navegador​

Busca o elemento diretamente na página.

ID da página ou navegador​

A ação de abertura de navegador, aba ou iframe onde a busca será feita.

Um elemento já selecionado​

Busca o elemento dentro do escopo de um elemento pai já obtido por uma ação Obter elemento.

ID do elemento​

A ação de Obter elemento anterior para usar como contexto de busca.

Um item de uma seleção de vários elementos​

Busca o elemento dentro de um item de uma lista capturada por uma ação Obter Vários Elementos.

ID da lista de elementos​

A ação de Obter Vários Elementos usada como lista de origem.

Informe o índice da lista​

Posição do elemento pai na lista. O índice começa em 0.

Seletor do elemento​

Seletor CSS que identifica o elemento, por exemplo button#btnConfirmar. Nos modos Um elemento já selecionado e Um item de uma seleção de vários elementos, a busca é feita dentro do elemento pai.

Estado do elemento​

Disponível apenas no modo Um elemento no navegador. Estado esperado do elemento antes de retorná-lo: Visível, Invisível/Escondido, Não esteja presente no DOM ou Esteja presente no DOM. Padrão: Visível.

Tempo de espera​

Disponível apenas no modo Um elemento no navegador. Tempo máximo em segundos que o robô aguardará o elemento no estado definido. Padrão: 120.

Retornos​

Esta ação não possui campos de retorno. O elemento obtido fica disponível pelo ID desta ação no campo ID do elemento das ações de navegador que oferecem o modo Um elemento já selecionado, como Clicar e Inserir texto.

Regras e Condições​

  • O campo Seletor do elemento é obrigatório em todos os modos. No modo Um elemento no navegador, o campo ID da página ou navegador também precisa ser informado.
  • No modo Um elemento já selecionado, o campo ID do elemento é obrigatório e o elemento é buscado dentro do escopo do elemento pai.
  • No modo Um elemento no navegador, o robô aguarda o elemento atingir o estado configurado antes de prosseguir. Se o tempo de espera for excedido, a ação encerra com erro.