Pular para o conteúdo principal
Acessar Studio
Navegador

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.

Por navegador​

Localiza os elementos usando seletor CSS na página.

ID da página ou navegador​

A ação de abertura de navegador, aba ou iframe onde os elementos serão buscados.

Seletor do elemento​

Seletor CSS que identifica os elementos a serem obtidos na página, por exemplo tr.linhaTabela.

Estado do elemento​

Estado esperado dos elementos antes de retorná-los: 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á os elementos no estado definido. Padrão: 120.

Por elemento​

Localiza os elementos dentro do escopo de um elemento pai 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​

Localiza elementos dentro de um item 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 pai na lista. O índice começa em 0.

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​

  • No modo Por navegador, os campos ID da página ou navegador e Seletor do elemento são obrigatórios.
  • O campo size retorna 0 se nenhum elemento corresponder ao seletor informado (não gera erro).
  • A lista é indexada a partir de 0 (primeiro elemento corresponde ao índice 0).