# Encontrar Elemento

Você pode fazer o seguinte com o nó atual:

1. Encontrar elementos da árvore de visualização na página atual e clicar no elemento através do nó [Tocar no Elemento](/pt/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element)
2. Encontrar elementos específicos da árvore de visualização e obter os atributos do elemento através do nó [Executar Script JS](/pt/rparobotic-process-automation/03-node/02-data-processing/01-run-js-script)
3. Encontrar elementos específicos da árvore de visualização e verificar se o elemento existe através da saída do nó atual, semelhante à impressão de logs na depuração de impressão


[O que é uma árvore de visualização?](/pt/rparobotic-process-automation/05-appendix/02-what-is-a-view-tree)

## Parâmetros

- **Tipo de Seletor** Lista suspensa
- Por Encontrar Elemento
- Usar Elemento Anterior


Se "Por Encontrar Elemento" estiver selecionado, você pode filtrar elementos pelas seguintes condições do nó DOM. Os elementos que corresponderem às condições de atributo definidas serão filtrados pelo executor.

- Você pode adicionar condições obrigatórias em **[Quando a Condição for Atendida]**. Suporta as seguintes 4 condições, com até 4 filtros paralelos suportados simultaneamente:
- texto
- fullId
- classe
- descrição


Você pode obter os atributos do elemento na tela atual do celular na nuvem por meio das ferramentas de desenvolvedor.

- **[Quando houver vários objetos correspondentes na página]**
- Obter elemento único
- **[Qual elemento selecionar?]**
- Quando "Obter elemento único" estiver selecionado, esta opção aparecerá. Você pode inserir o número do índice correspondente; por exemplo, inserir o número 1 significa que você obterá o primeiro elemento correspondente.
- Obter lista de elementos


"Usar Elemento Anterior": Corresponde diretamente ao nó DOM do elemento na execução atual. Esta função é frequentemente usada com o nó "Encontrar Elemento". - **Tempo Máximo de Espera para o Elemento Aparecer**

- Após inserir o número, o localizador atual buscará o elemento que você precisa encontrar. A execução continua após o elemento ser encontrado. Se o elemento não for encontrado dentro desse tempo, o próximo nó inicia a execução.
- Pode-se inserir ou referenciar um número, cuja unidade é milissegundos.
- **[Atraso Após Encontrar o Elemento]**


## Saída

- **Parâmetros de Saída**
- Elemento: Saída no formato de nó (na verdade, JSON). Você pode analisar o conteúdo do elemento diretamente executando "Executar Script JS".
- **Registro de Execução**
- Hora de Início
- Hora de Término
- Duração (ms)
- Status (Sucesso/Falha)


## Exemplo

1. Na página de lista de aplicativos do sistema Android, você pode exibir o elemento DOM de cada aplicativo por meio do nó "Encontrar Elemento". Na próxima etapa, você pode iterar pelo elemento DOM de cada aplicativo usando o nó Loop e, em seguida, verificar o nome de cada aplicativo usando o nó Executar Script JS.


#### Configuração:

| Nome do Campo | Valor do Campo |

| -------------------------------------------------------- | ----------------------------------------------- |

| **Quando a Condição for Atendida** | "fullID" Igual a "com.android.launcher3:id/icon" |

| **Quando houver vários objetos correspondentes na página** | Obter lista de elementos |

| **Tempo limite para aguardar o elemento aparecer** | 3000 |

| **Atraso após Encontrar o Elemento** | 0 |

#### Saída:

#### Parâmetros de Saída

"**Lista de elementos**" é uma lista com o valor:

details
summary
Clique para expandir/recolher
```json
    [ { "isScrollable": false, "centerX": 135, "uuid": "1b03ee9a-91bd-457f-9981-7f2bfba0905b", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "index": 0, "isCheckable": false, "childCount": 0, "bounds": { "top": 261, "right": 270, "left": 0, "bottom": 621 }, "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "contentDescription": "Calendar", "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "centerY": 441, "text": "Calendar", "isVisibleToUser": true }, { "isScrollable": false, "text": "Chrome", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "index": 1, "isCheckable": false, "uuid": "6446a15a-47e9-4ee3-adcd-8f63197653d4", "childCount": 0, "contentDescription": "Chrome", "packageName": "com.android.launcher3", "isSelected": false, "bounds": { "top": 261, "right": 540, "bottom": 621, "left": 270 }, "centerX": 405, "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "centerY": 441, "isVisibleToUser": true }, { "isScrollable": false, "centerX": 675, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "uuid": "d5ae8607-be23-4166-a332-32911dc5eae0", "isCheckable": false, "childCount": 0, "index": 2, "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "isClickable": true, "text": "Clock", "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "contentDescription": "Clock", "centerY": 441, "bounds": { "right": 810, "top": 261, "left": 540, "bottom": 621 }, "isVisibleToUser": true }, { "isScrollable": false, "contentDescription": "Contacts", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "index": 3, "childCount": 0, "packageName": "com.android.launcher3", "isSelected": false, "text": "Contacts", "isFocusable": true, "isPassword": false, "centerX": 945, "uuid": "6f920c6c-221c-425c-b5b1-d438b1fc7fe9", "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "centerY": 441, "bounds": { "top": 261, "right": 1080, "bottom": 621, "left": 810 }, "isVisibleToUser": true }, { "isScrollable": false, "centerX": 135, "centerY": 801, "bounds": { "bottom": 981, "right": 270, "left": 0, "top": 621 }, "isLongClickable": true, "text": "Files", "resourceId": "com.android.launcher3:id/icon", "contentDescription": "Files", "isCheckable": false, "childCount": 0, "packageName": "com.android.launcher3", "index": 4, "isSelected": false, "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "uuid": "3e8b09e7-4948-4132-9ca8-0ca57cf5a12d", "isVisibleToUser": true }, { "isScrollable": false, "contentDescription": "Gallery", "centerY": 801, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "index": 5, "text": "Gallery", "packageName": "com.android.launcher3", "isSelected": false, "centerX": 405, "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "uuid": "7b1b7b09-3ca0-422d-b35a-37ce26e2517b", "isVisibleToUser": true, "bounds": { "bottom": 981, "right": 540, "top": 621, "left": 270 } }, { "isScrollable": false, "centerY": 801, "centerX": 675, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "packageName": "com.android.launcher3", "isSelected": false, "bounds": { "right": 810, "bottom": 981, "top": 621, "left": 540 }, "index": 6, "contentDescription": "Gmail", "uuid": "9b8815b9-1079-4969-bf77-c3b27e4656f0", "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true, "text": "Gmail" }, { "isScrollable": false, "text": "Instagram", "centerY": 801, "uuid": "045888d5-9154-4a2a-b6da-649f6c54e9da", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "bounds": { "bottom": 981, "right": 1080, "top": 621, "left": 810 }, "isCheckable": false, "childCount": 0, "contentDescription": "Instagram", "packageName": "com.android.launcher3", "isSelected": false, "index": 7, "isFocusable": true, "isPassword": false, "centerX": 945, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true }, { "isScrollable": false, "index": 8, "uuid": "4ad6d1e9-02a4-4163-968b-b764968a2e1b", "centerX": 135, "text": "Messaging", "isLongClickable": true, "bounds": { "top": 981, "right": 270, "left": 0, "bottom": 1341 }, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "centerY": 1161, "contentDescription": "Messaging", "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true }, { "isScrollable": false, "index": 9, "text": "MoreLogin Bot", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "centerY": 1161, "packageName": "com.android.launcher3", "isSelected": false, "contentDescription": "MoreLogin Bot", "centerX": 405, "isFocusable": true, "isPassword": false, "isClickable": true, "uuid": "fa990303-fa24-4c27-bc1b-32dec1d15fc7", "bounds": { "top": 981, "right": 540, "bottom": 1341, "left": 270 }, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true }, { "isScrollable": false, "index": 10, "bounds": { "right": 810, "top": 981, "left": 540, "bottom": 1341 }, "centerX": 675, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "centerY": 1161, "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "isClickable": true, "contentDescription": "Open Camera", "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "text": "Open Camera", "uuid": "55fd0ae2-cb1b-44f9-93af-91064aaebea2", "isVisibleToUser": true }, { "isScrollable": false, "index": 11, "contentDescription": "Phone", "bounds": { "top": 981, "right": 1080, "bottom": 1341, "left": 810 }, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "uuid": "355737cc-e262-4c9a-872a-79ce9ff01bdd", "isCheckable": false, "childCount": 0, "centerY": 1161, "packageName": "com.android.launcher3", "isSelected": false, "text": "Phone", "isFocusable": true, "isPassword": false, "centerX": 945, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true }, { "isScrollable": false, "centerX": 135, "index": 12, "uuid": "dec9c272-397c-4395-8985-e2e583d5a567", "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "centerY": 1521, "isClickable": true, "text": "Play Store", "bounds": { "bottom": 1701, "right": 270, "left": 0, "top": 1341 }, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "contentDescription": "Play Store", "isVisibleToUser": true }, { "isScrollable": false, "contentDescription": "Search", "index": 13, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "bounds": { "bottom": 1701, "right": 540, "top": 1341, "left": 270 }, "childCount": 0, "text": "Search", "packageName": "com.android.launcher3", "isSelected": false, "centerX": 405, "isFocusable": true, "isPassword": false, "centerY": 1521, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true, "uuid": "5c96c836-ea08-49a8-809b-10e7efb218de" }, { "isScrollable": false, "uuid": "aaf1f6f6-109f-4b28-b0f4-1206f2fbeabc", "text": "Settings", "centerX": 675, "isLongClickable": true, "index": 14, "resourceId": "com.android.launcher3:id/icon", "isCheckable": false, "childCount": 0, "contentDescription": "Settings", "packageName": "com.android.launcher3", "isSelected": false, "isFocusable": true, "isPassword": false, "centerY": 1521, "isClickable": true, "bounds": { "right": 810, "bottom": 1701, "top": 1341, "left": 540 }, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "isVisibleToUser": true } ]
```

1. Na página de lista de aplicativos do sistema Android, você pode exibir o valor do segundo elemento DOM na lista de elementos que correspondem à condição por meio do nó "Encontrar Elemento". O elemento pode ser clicado por meio do nó "Tocar no Elemento".


#### Configuração:

| Nome do Campo | Valor do Campo |

| -------------------------------------------------------- | ---------------------------------------------- |

| **Quando a Condição for Atendida** | "fullID igual a "com.android.launcher3:id/icon" |
| **Quando houver vários objetos correspondentes na página** | "Obter elemento único" |

| **Qual elemento selecionar?** | "2" |

| **Tempo limite para aguardar o elemento aparecer** | "3000" |

| **Atraso após encontrar o elemento** | "0" |

#### Saída:

#### Parâmetros de saída

"**Elemento**" é um objeto de elemento (JSON) com o valor:

details
summary
Clique para expandir/recolher
```json
    { "isScrollable": false, "text": "Chrome", "bounds": { "top": 261, "right": 540, "bottom": 621, "left": 270 }, "isLongClickable": true, "resourceId": "com.android.launcher3:id/icon", "index": 1, "isCheckable": false, "childCount": 0, "contentDescription": "Chrome", "packageName": "com.android.launcher3", "isSelected": false, "centerX": 405, "isFocusable": true, "isPassword": false, "isClickable": true, "isChecked": false, "isFocused": false, "isEnabled": true, "className": "android.widget.TextView", "centerY": 441, "isVisibleToUser": true, "uuid": "4aa1242a-daa8-46dd-8bf4-f100f3cf228a" }
```

Você pode ver que o valor de contentDescription é "Chrome". Na próxima etapa, você pode clicar neste elemento através do nó [Tap Element](/pt/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element).

## Nós Relacionados

- [Tap Element](/pt/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element)
- [Run JS Script](/pt/rparobotic-process-automation/03-node/02-data-processing/01-run-js-script)