Тип узла: browser_getElement
Читает текст, HTML или указанный атрибут одного или нескольких найденных элементов.

Снимок сделан в английском интерфейсе MoreLogin Desktop V2.73.101.
Эти поля указываются в data.browserUi.inputs.
| Поле | Тип или значения | Обязательно по схеме | По умолчанию при выполнении | Описание и ограничения |
|---|---|---|---|---|
selectorType | "selector" / "element" / "frame" (поддерживает ссылки на переменные) | Нет | "selector" | Источник элемента. Начальное значение в редакторе: "selector" |
frame | string | Нет | — | Переменная iframe |
element | string | Нет | — | Переменная элемента |
selectorRadio | "CSS" / "XPath" (поддерживает ссылки на переменные) | Нет | "CSS" | Тип селектора. Начальное значение в редакторе: "CSS". Например, "${locatorType}"; значение, на которое указывает ссылка, должно быть "CSS" или "XPath". |
selector | string | Нет | — | Селектор |
outputRange | "single" / "all" (поддерживает ссылки на переменные) | Нет | "single" | Если совпадает несколько элементов. Начальное значение в редакторе: "single" |
serialType | "fixed" / "randomInterval" (поддерживает ссылки на переменные) | Нет | "fixed" | Если совпадает несколько элементов. Начальное значение в редакторе: "fixed" |
serial | WorkflowNumber | Нет | 1 | Индекс элемента; целое число; минимум после вычисления: 1. Начальное значение в редакторе: 1 |
serialMin | WorkflowNumber | Нет | — | Минимальный индекс; целое число; минимум после вычисления: 1 |
serialMax | WorkflowNumber | Нет | — | Максимальный индекс; целое число; минимум после вычисления: 1 |
type | "innerText" / "innerHTML" / "attribute" (поддерживает ссылки на переменные) | Нет | "innerText" | Тип выходных данных. Начальное значение в редакторе: "innerText" |
key | string | Нет | — | Имя атрибута / селектор дочернего элемента |
- Правила поиска элемента: для selectorType=selector нужен selector; для frame нужны frame+selector; для element нужна ссылка ElementRef из предыдущего узла. serial начинается с 1. randomInterval использует serialMin/serialMax, и минимум не может быть больше максимума. Сначала узел ждёт, пока селектор найдёт элементы, затем один раз выбирает индекс: верхняя граница диапазона ограничивается фактическим числом совпадений. Если фиксированный индекс или нижняя граница диапазона больше числа совпадений, сразу возвращается ELEMENT_NOT_FOUND (reason=range, details.field равно serial или serialMin), и никаких действий со страницей не выполняется. outputRange может быть только single/all. type может быть только innerText/innerHTML/attribute (как в редакторе; для объектов элементов используйте getElementRef, а для iframe используйте getFrame), а для type=attribute нужен key (имя атрибута). Читайте возвращённые ключи и значения как одно значение или как массив в зависимости от ветви. Узел не ждёт появления элемента: если ничего не найдено, он сразу завершается успешно, одиночное значение равно пустой строке "" (для all это []), а отсутствующий атрибут равен "". Если нужно дождаться элемента, сначала используйте узел «Дождаться элемента».
- Код ошибки проверки:
RPA_NODE_INPUT_INVALID
| Поле | Допустимые формы |
|---|---|
selectorType | literal, template |
frame | literal, template |
element | literal, template |
selectorRadio | literal, template |
selector | literal, template |
outputRange | literal, template |
serialType | literal, template |
serial | literal, numericExpression |
serialMin | literal, numericExpression |
serialMax | literal, numericExpression |
type | literal, template |
key | literal, template |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле выходных данных | Тип или значения |
|---|---|
text | string |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле выходных данных | Тип или значения |
|---|---|
text | array<string> |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле выходных данных | Тип или значения |
|---|---|
html | string |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле выходных данных | Тип или значения |
|---|---|
html | array<string> |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}
| Поле выходных данных | Тип или значения |
|---|---|
attribute | string / null |
matchedCount | number |
Режим {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}
| Поле выходных данных | Тип или значения |
|---|---|
attribute | array<string / null> |
matchedCount | number |
Ссылайтесь на опубликованные поля в виде ${nodeId.data.field}.
В этом примере текст первого элемента, соответствующего .price, читается в data.text. Если элемент загружается асинхронно, сначала добавьте узел «Дождаться элемента».
{
"id": "read_price",
"type": "browser_getElement",
"data": {
"title": "Read the product price",
"browserAction": "getElement",
"browserUi": {
"inputs": {
"selectorType": "selector",
"selectorRadio": "CSS",
"selector": ".price",
"outputRange": "single",
"serialType": "fixed",
"serial": 1,
"type": "innerText"
},
"exception": {
"timeout": 30000,
"policy": "interrupt"
}
}
}
}