Pular para o conteúdo principal
Docs
Acessar Studio
Roberty Studio
RPANavegador

Obter Vários Elementos

Obter Vários Elementos

Localiza e retorna uma lista de todos os elementos HTML que correspondem ao seletor CSS informado na página do navegador. Útil para iterar sobre listas, tabelas e conjuntos de elementos repetidos.


Opções​

Selecione a ação​

Define a origem da busca.

Um elemento no navegador​

Busca os elementos 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 os elementos 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 os elementos 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 os elementos a serem obtidos, por exemplo tr.linhaTabela. 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 dos elementos antes de retorná-los: Visível ou Invisível/Escondido. 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á os elementos no estado definido. Padrão: 120.

Retornos​

Código Javascript​

js
actions["id-da-acao"].elements // lista de elementos HTML encontrados (Lista)
actions["id-da-acao"].size     // quantidade total de elementos encontrados (Número)

Seleção de campos​

  • elements — lista de elementos HTML encontrados na página, disponível no campo ID da lista de elementos de outras ações (Lista)
  • size — quantidade total de elementos encontrados que correspondem ao seletor informado (Número)

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 no navegador, o robô aguarda os elementos atingirem o estado configurado; se o tempo de espera for excedido sem nenhum elemento encontrado, a ação encerra com erro.
  • Nos modos Um elemento já selecionado e Um item de uma seleção de vários elementos, se nenhum elemento corresponder ao seletor, size retorna 0 (não gera erro).
  • A lista é indexada a partir de 0 (primeiro elemento corresponde ao índice 0).