Pular para o conteúdo principal
Acessar Studio
Navegador

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.

Por navegador​

Localiza o elemento usando seletor CSS na página.

ID da página ou navegador​

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

Seletor do elemento​

Seletor CSS que identifica o elemento na página, por exemplo button#btnConfirmar.

Estado do elemento​

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

Tempo de espera​

Tempo máximo em segundos que o robô aguardará o elemento no estado definido. Padrão: 120.

Por elemento​

Localiza 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.

Por lista de elementos​

Obtém um elemento específico de uma lista capturada por uma ação Obter Elementos.

ID da lista de elementos​

A ação de Obter vários elementos como lista de origem.

Informe o índice da lista​

Posição do elemento desejado dentro da lista. O índice começa em 0.

Retornos​

Código Javascript​

js
actions["id-da-acao"] // referência ao elemento HTML obtido (Elemento)

Seleção de campos​

O elemento obtido fica disponível no campo ID do elemento de outras ações como Clique no Navegador, Inserir texto e demais ações que suportam o modo Por elemento.

Regras e Condições​

  • No modo Por navegador, os campos ID da página ou navegador e Seletor do elemento são obrigatórios.
  • No modo Por elemento, o campo ID do elemento é obrigatório e o elemento é buscado dentro do escopo do elemento pai.
  • 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.