# Найти элемент

С текущим узлом можно выполнить следующие действия:

1. Найти элементы дерева представлений на текущей странице, затем щелкнуть по элементу с помощью узла [Tap Element](/ru/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element)
2. Найти конкретные элементы дерева представлений, затем получить атрибуты элемента с помощью узла [Run JS Script](/ru/rparobotic-process-automation/03-node/02-data-processing/01-run-js-script)
3. Найти конкретные элементы дерева представлений, затем проверить, существует ли элемент, с помощью вывода текущего узла, аналогично выводу логов в режиме отладки


[Что такое дерево представлений?](/ru/rparobotic-process-automation/05-appendix/02-what-is-a-view-tree)

## Параметры

- **Тип селектора** Выпадающий список
- По поиску Элемент
- Использовать предыдущий элемент


Если выбран параметр «Поиск элемента», вы можете фильтровать элементы по следующим условиям DOM-узла. Элементы, соответствующие заданным вами условиям атрибутов, будут отфильтрованы исполнителем.

- Вы можете добавить обязательные условия в **[При выполнении условия]**. Поддерживаются следующие 4 условия, до 4 параллельных фильтров одновременно:
- текст
- fullId
- класс
- desc


Вы можете получить атрибуты элементов текущего экрана облачного телефона через инструменты разработчика.

- **[Когда на странице есть несколько совпадающих объектов]**
- Получить один элемент
- **[Какой элемент выбрать?]**
- Если выбран параметр «Получить один элемент», появляется эта опция. Вы можете ввести соответствующий номер индекса, например, ввод числа 1 означает, что вы получите первый совпадающий элемент.
- Получить список элементов


"Использовать предыдущий элемент": Непосредственно сопоставляет DOM-узел элемента в фактическом выполнении. Эта функция часто используется с узлом "Поиск элемента".

- **Максимальное время ожидания появления элемента**
- После ввода числа текущий узел поиска будет опрашивать наличие нужного элемента. Выполнение продолжается после нахождения элемента. Если элемент не найден в течение этого времени, начинается выполнение следующего узла.
- Можно ввести или указать число, единица измерения — миллисекунды.
- **[Задержка после нахождения элемента]**


## Вывод

- **Параметры вывода**
- Элемент: вывод в формате узла (фактически JSON). Вы можете напрямую проанализировать содержимое элемента, выполнив "Запуск JS-скрипта".
- **Журнал выполнения**
- Время начала
- Время окончания
- Длительность (мс)
- Статус (Успех/Неудача)


## Пример

1. На странице списка приложений в системе Android вы можете вывести DOM-элемент каждого приложения с помощью узла "Найти элемент". На следующем шаге вы можете пройтись по DOM-элементам каждого приложения с помощью узла Loop, а затем проверить название каждого приложения с помощью узла Run JS Script.


#### Конфигурация:

| Имя поля | Значение поля |

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

| **При выполнении условия** | "fullID" равно "com.android.launcher3:id/icon" |

| **При наличии нескольких совпадающих объектов на странице** | Получить список элементов |

| **Тайм-аут ожидания появления элемента** | 3000 |

| **Задержка после обнаружения элемента** | 0 |

#### Вывод:

##### Выходные параметры

"**Список элементов**" — это список со значениями:

details
summary
Нажмите, чтобы развернуть/свернуть
```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. На странице списка приложений в системе Android вы можете вывести значение второго элемента DOM из списка элементов, соответствующих условию, с помощью узла «Найти элемент». К этому элементу можно перейти, нажав на узел «Нажать на элемент».


#### Конфигурация:

| Имя поля | Значение поля |

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

| **При выполнении условия** | "fullID равен "com.android.launcher3:id/icon" |

| **Когда на странице есть несколько совпадающих объектов** | "Получить один элемент" |

| **Какой элемент выбрать?** | "2" |

| **Тайм-аут ожидания появления элемента** | "3000" |

| **Задержка после нахождения элемента** | "0" |

#### Вывод:

##### Параметры вывода

"**Элемент**" — это объект элемента (JSON) со значением:

details
summary
Нажмите, чтобы развернуть/свернуть
```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" }
```

Вы можете увидеть, что значение contentDescription равно "Chrome". На следующем шаге вы можете щелкнуть этот элемент через узел [Tap Element](/ru/rparobotic-process-automation/03-node/01-simulation-operations/04-tap-element).

## Связанные узлы

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