# Buscar elemento

Puede realizar las siguientes acciones con el nodo actual:

1. Buscar elementos del árbol de vista en la página actual y, a continuación, hacer clic en el elemento mediante el nodo [Tocar elemento](/es/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element).
2. Buscar elementos específicos del árbol de vista y, a continuación, obtener sus atributos mediante el nodo [Ejecutar script JS](/es/rparobotic-process-automation/03-node/02-data-processing/01-run-js-script).
3. Buscar elementos específicos del árbol de vista y, a continuación, comprobar si el elemento existe mediante la salida del nodo actual, de forma similar a la impresión de registros en la depuración de impresión.


[¿Qué es un árbol de vista?](/es/rparobotic-process-automation/05-appendix/02-what-is-a-view-tree)

## Parámetros

- **Tipo de selector** Menú desplegable
- Buscar elemento
- Usar elemento anterior


Si selecciona "Buscar elemento", puede filtrar elementos según las siguientes condiciones del nodo DOM. El ejecutor filtrará los elementos que coincidan con las condiciones de atributo que haya definido.

- Puede agregar las condiciones necesarias en **[Cuando se cumple la condición]**. Admite las siguientes 4 condiciones, con hasta 4 filtros paralelos simultáneos:
- texto
- ID completo
- clase
- descripción


Puede obtener los atributos de los elementos de la pantalla actual del teléfono en la nube mediante las herramientas para desarrolladores.

- **[Cuando hay varios objetos coincidentes en la página]**
- Obtener un solo elemento
- **[¿Qué elemento seleccionar?]**
- Cuando selecciona "Obtener un solo elemento", aparece esta opción. Puede ingresar el índice correspondiente; por ejemplo, ingresar el número 1 significa que obtendrá el primer elemento coincidente.
- Obtener lista de elementos


"Usar elemento anterior": Coincide directamente con el nodo DOM del elemento en ejecución. Esta función se usa frecuentemente con el nodo "Buscar elemento".

- **Tiempo máximo de espera para que aparezca el elemento**
- Tras introducir el número, el buscador actual consultará el elemento que necesita encontrar. La ejecución continúa una vez encontrado el elemento. Si no se encuentra en este tiempo, se inicia la ejecución del siguiente nodo.
- Se puede introducir o referenciar un número; la unidad es milisegundos.
- **[Retraso tras encontrar el elemento]**


## Salida

- **Parámetros de salida**
- Elemento: Salida en formato de nodo (JSON). Puede analizar el contenido del elemento directamente ejecutando "Ejecutar script JS".
- **Registro de ejecución**
- Hora de inicio
- Hora de finalización
- Duración (ms)
- Estado (Éxito/Error)


## Ejemplo

1. En la página de lista de aplicaciones del sistema Android, puede mostrar el elemento DOM de cada aplicación mediante el nodo Buscar elemento. En el siguiente paso, puedes iterar sobre el elemento DOM de cada aplicación mediante el nodo Loop y, a continuación, comprobar el nombre de cada aplicación mediante el nodo Run JS Script.


#### Configuración:

| Nombre del campo | Valor del campo |

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

| **Cuando se cumple la condición** | "fullID" es igual a "com.android.launcher3:id/icon" |

| **Cuando hay varios objetos coincidentes en la página** | Obtener lista de elementos |

| **Tiempo de espera para que aparezca el elemento** | 3000 |

| **Retraso tras encontrar el elemento** | 0 |

#### Salida:

##### Parámetros de salida

"**Lista de elementos**" es una lista con el valor:

details
summary
Haz clic para expandir/contraer
```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 } ]
```

br
1. En la página de lista de aplicaciones del sistema Android, puede mostrar el valor del segundo elemento DOM de la lista de elementos que coinciden con la condición mediante el nodo Buscar elemento. Se puede hacer clic en el elemento mediante el nodo Tocar elemento.


#### Configuración:

| Nombre del campo | Valor del campo |

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

| **Cuando se cumple la condición** | "fullID es igual a "com.android.launcher3:id/icon" |

| **Cuando hay varios objetos coincidentes en la página** | "Obtener un solo elemento" |

| **¿Qué elemento seleccionar?** | "2" |

| **Tiempo de espera para que aparezca el elemento** | "3000" |

| **Retraso tras encontrar el elemento** | "0" |

#### Salida:

##### Parámetros de salida

"**Elemento**" es un objeto de elemento (JSON) con el valor:

details
summary
Haga clic para expandir/contraer
```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" }
```

Puedes ver que el valor de contentDescription es "Chrome". En el siguiente paso, puedes hacer clic en este elemento mediante el nodo [Tap Element](/es/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element).

## Nodos relacionados

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