Циклы

Итерация по данным и циклическая обработка в n8n

Автоматическая итерация

По умолчанию n8n автоматически обрабатывает каждый item:

Нода выполнится 3 раза — по одному для каждого item.

Loop Over Items

Явный цикл с контролем итерации.

Когда использовать

Обработка с паузами (rate limiting)
Batch processing
Условная остановка цикла
Отслеживание прогресса

Настройка

Параметр	Описание
Batch Size	Items за одну итерацию
Options	Reset, Pause

Пример: Rate-limited API

Loop Over Items: Batch Size = 1
HTTP Request: API вызов
Wait: 1 секунда
Done: Подключить выход “done”

Split In Batches

Разбиение на пакеты для параллельной обработки.

Настройка

Параметр	Описание
Batch Size	Размер пакета

Паттерн обработки

// В Code после Split In Batches
const batch = $input.all();

// Обработка пакета
const results = await Promise.all(
  batch.map(item => processItem(item))
);

return results;

Рекурсивные workflow

Вызов workflow из самого себя для обработки иерархий.

Execute Workflow (Self)

Пример: Обход дерева

// Входные данные
{
  "id": 1,
  "children": [
    { "id": 2, "children": [] },
    { "id": 3, "children": [
      { "id": 4, "children": [] }
    ]}
  ]
}

Workflow:

Получить текущий узел
Обработать узел
Для каждого child вызвать этот же workflow
Собрать результаты

While-цикл через Loop

Цикл с условием выхода:

Реализация

// В Code ноде внутри цикла
const currentItem = $input.first();
const shouldContinue = currentItem.json.hasMore;

if (!shouldContinue) {
  // Завершить цикл
  return [];
}

// Продолжить
return [currentItem];

Pagination

Получение данных постранично.

Встроенная пагинация

HTTP Request поддерживает автоматическую пагинацию:

Параметр	Значение
Pagination Mode	Update a Parameter Each Request
Parameter	`page`
Start Value	1
Update	+1

Ручная пагинация

// В Code ноде
const response = $input.first().json;
const currentPage = $('Set Page').first().json.page;

if (response.hasNextPage) {
  return [{
    json: {
      page: currentPage + 1,
      data: response.data
    }
  }];
}

// Пагинация завершена
return [{ json: { done: true, allData: response.data }}];

Performance Tips

Batch вместо поэлементной обработки

// ❌ Медленно
items.forEach(async item => {
  await apiCall(item);
});

// ✅ Быстро
await apiCall(items); // Если API поддерживает batch

Параллельная обработка

Используйте Split In Batches с оптимальным размером:

Маленькие batches: меньше памяти, больше overhead
Большие batches: больше памяти, меньше overhead
Оптимум: 50-100 items при batch API

Ограничение параллелизма

// В Code ноде
const CONCURRENT_LIMIT = 5;
const items = $input.all();
const results = [];

for (let i = 0; i < items.length; i += CONCURRENT_LIMIT) {
  const batch = items.slice(i, i + CONCURRENT_LIMIT);
  const batchResults = await Promise.all(
    batch.map(item => processItem(item))
  );
  results.push(...batchResults);
}

return results.map(r => ({ json: r }));

Паттерны

Retry с экспоненциальным backoff

const maxRetries = 3;
let attempt = $input.first().json.attempt || 0;

try {
  const result = await riskyOperation();
  return [{ json: result }];
} catch (error) {
  if (attempt < maxRetries) {
    // Продолжить цикл с увеличенным attempt
    return [{
      json: {
        attempt: attempt + 1,
        waitTime: Math.pow(2, attempt) * 1000
      }
    }];
  }
  throw error;
}

Cursor-based пагинация

const response = $input.first().json;
const cursor = response.nextCursor;

if (cursor) {
  return [{
    json: {
      cursor,
      accumulatedData: [
        ...($json.accumulatedData || []),
        ...response.data
      ]
    }
  }];
}

// Все данные получены
return [{
  json: {
    data: [...($json.accumulatedData || []), ...response.data]
  }
}];

Следующие шаги

Трансформация данных — преобразование
Слияние данных — объединение потоков
Code Node — программирование в n8n

Циклы

Автоматическая итерация

Loop Over Items

Когда использовать

Настройка

Пример: Rate-limited API

Split In Batches

Настройка

Паттерн обработки

Рекурсивные workflow

Execute Workflow (Self)

Пример: Обход дерева

While-цикл через Loop

Реализация

Встроенная пагинация

Ручная пагинация

Performance Tips

Batch вместо поэлементной обработки

Параллельная обработка

Ограничение параллелизма

Паттерны

Retry с экспоненциальным backoff

Cursor-based пагинация

Следующие шаги

Начало работы

Workflows

Ключевые концепции

AI и MCP

Интеграции

Хостинг

Код в n8n

Справочник