# Цикл

Тип вузла `browser_loop`

## Призначення

Повторює блок за кількістю, колекцією, списком елементів або умовою.

## Налаштування в настільному клієнті

![Налаштування вузла «Цикл» в настільному клієнті](/assets/loop.05af990d8a1370b3ba27df4f2866f602b0bf111eae56e77efd72402fe3cdc089.0538f3a9.webp)

Знімок екрана зроблено в англійському інтерфейсі MoreLogin Desktop V2.73.101.

## Вхідні дані

Ці поля розміщуються в `data.browserUi.inputs`.

| Поле | Тип або значення | Обов'язкове за схемою | Значення за замовчуванням під час виконання | Опис і обмеження |
|  --- | --- | --- | --- | --- |
| `loopMode` | `"times"` / `"elements"` / `"list"` / `"while"` (підтримує посилання на змінні) | Ні | `"times"` | Режим циклу. Початкове значення в редакторі: `"times"` |
| `times` | `WorkflowNumber` | Ні | `3` | Кількість повторень; ціле число; мінімум після розв'язання: 1; максимум після розв'язання: 10000. Початкове значення в редакторі: `3` |
| `selectorRadio` | `"CSS"` / `"XPath"` (підтримує посилання на змінні) | Ні | `"CSS"` | Тип селектора. Початкове значення в редакторі: `"CSS"` |
| `selector` | `string` | Ні | — | Селектор |
| `serial` | `WorkflowNumber` | Ні | `1` | Індекс елемента; ціле число; мінімум після розв'язання: 1. Початкове значення в редакторі: `1` |
| `type` | `"object"` / `"innerText"` / `"innerHTML"` / `"attribute"` / `"contentFrame"` (підтримує посилання на змінні) | Ні | `"innerText"` | Тип вихідних даних. Початкове значення в редакторі: `"innerText"` |
| `key` | `string` | Ні | — | Назва атрибута / селектор дочірнього елемента |
| `content` | `["null","boolean","number","string"]` / array<`JSON`> / `object` (підтримує посилання на змінні) | Ні | — | Дані списку |
| `loopConditions` | array<`object`> | Ні | — | Поки виконуються умови |
| `maxIterations` | `WorkflowNumber` | Ні | `10000` | Максимальна кількість ітерацій; ціле число; мінімум після розв'язання: 1; максимум після розв'язання: 10000. Початкове значення в редакторі: `10000` |
| `accumulatorMode` | `"none"` / `"collect"` / `"count"` / `"sum"` (підтримує посилання на змінні) | Ні | `"none"` | Режим накопичення. Початкове значення в редакторі: `"none"` |
| `initialState` | `["null","boolean","number","string"]` / array<`JSON`> / `object` (підтримує посилання на змінні) | Ні | — | Початкове накопичене значення |
| `accumulatorPath` | `string` | Ні | — | Шлях до поля накопичення (залиште порожнім, щоб використати результат цієї ітерації) |
| `breakEnabled` | `boolean` (підтримує посилання на змінні) | Ні | `false` | Умова дострокового виходу. Початкове значення в редакторі: `false` |
| `breakCondition` | `object` | Ні | — | Вийти, якщо умову виконано |


## Вимоги до режимів і обмеження

- Усі чотири типи циклів застосовують ліміт maxIterations (цикл while, що досягає ліміту, завершується звичайним чином з exitReason=max_iterations). accumulatorMode задає none/collect/count/sum (none, якщо пропущено), initialState задає початкове значення, accumulatorPath читає значення всередині data останнього вузла, а breakEnabled/breakCondition керують достроковим виходом. Для while loopConditions приймає лише масив правил [{field,operator,value}]. index починається з 1. Для списку об'єктів item={key,value}. type може мати лише значення object/innerText/innerHTML/attribute/contentFrame, і type=attribute потребує key. Пропущена гілка не використовує повторно вихідні дані попередньої ітерації.
- Код помилки перевірки: `RPA_NODE_INPUT_INVALID`


## Посилання у вхідних даних

| Поле | Дозволені форми |
|  --- | --- |
| `loopMode` | `literal`, `template` |
| `times` | `literal`, `numericExpression` |
| `selectorRadio` | `literal`, `template` |
| `selector` | `literal`, `template` |
| `serial` | `literal`, `numericExpression` |
| `type` | `literal`, `template` |
| `key` | `literal`, `template` |
| `content` | `literal`, `template` |
| `loopConditions` | `literal` |
| `maxIterations` | `literal`, `numericExpression` |
| `accumulatorMode` | `literal`, `template` |
| `initialState` | `literal`, `template` |
| `accumulatorPath` | `literal`, `template` |
| `breakEnabled` | `literal`, `template` |
| `breakCondition` | `literal` |


## Вихідні дані

| Поле вихідних даних | Тип або значення |
|  --- | --- |
| `index` | `number` / `null` |
| `item` | `["null","boolean","number","string"]` / array<`JSON`> / `object` |
| `total` | `number` |
| `iterationCount` | `number` |
| `completedCount` | `number` |
| `exited` | `boolean` |
| `state` | `["null","boolean","number","string"]` / array<`JSON`> / `object` |
| `results` | array<`["null","boolean","number","string"]` / array<`JSON`> / `object`> |
| `exitReason` | `"break"` / `"condition_false"` / `"max_iterations"` / `"completed"` |


Посилайтеся на опубліковані поля у форматі `${nodeId.data.field}`.

## Приклад JSON

Повний об'єкт вузла для масиву `nodes` сценарію або для `blocks` іншого вузла.

```json
{
  "id": "repeat_three_times",
  "type": "browser_loop",
  "data": {
    "title": "Repeat the check three times",
    "browserAction": "loop",
    "browserUi": {
      "inputs": {
        "loopMode": "times",
        "times": 3,
        "accumulatorMode": "none"
      }
    }
  },
  "blocks": [
    {
      "id": "reload_each_time",
      "type": "browser_refreshPage",
      "data": {
        "title": "Reload the page",
        "browserAction": "refreshPage",
        "browserUi": {
          "inputs": {
            "postWaitMs": 1000
          },
          "exception": {
            "timeout": 30000,
            "policy": "interrupt"
          }
        }
      }
    }
  ]
}
```

[Назад до каталогу вузлів](/uk/browser-rpa/nodes)