---
title: "JavaScript в n8n: примеры для Code node - Nodbot"
source_url: "https://nodbot.ru/code/javascript/"
canonical_url: "https://nodbot.ru/code/javascript/"
language: "ru"
content_type: "KnowledgePage"
section: "code"
generated_at: "2026-05-30"
word_count_source: 894
---

# JavaScript в n8n: примеры для Code node

## AI summary

Практический гайд «JavaScript в n8n: примеры для Code node»: настройка workflow в n8n, типовые ошибки, проверка результата и production-чеклист.

## Best used for

Страница объясняет «JavaScript в n8n: примеры для Code node - Nodbot» в контексте n8n/Nodbot: когда применять, как проверить внедрение и какие ошибки исключить.

## Key topics

- Возврат items
- Нормализация лида
- Фильтр и дедупликация
- Типичные ошибки
- Инженерный контракт для кода в n8n
- Как проверять код и expressions
- Пример безопасного входного контракта
- Критерий готовности

## Source outline

# JavaScript в n8n: примеры для Code node

Обновлено: 2026-05-29

JavaScript в n8n чаще всего используется в Code node для трансформации данных. Он полезен, когда Set, IF и Switch уже не хватает: нужно пройтись по массиву, сгруппировать строки, удалить дубли или подготовить payload для API.

## Возврат items

```
return items.map(item => ({
  json: {
    ...item.json,
    email: (item.json.email || "").toLowerCase(),
  },
}));
```
Выходом должен быть массив objects с полем json .

## Нормализация лида

```
return items.map(item => {
  const lead = item.json;
  return { json: {
    name: lead.name || lead.full_name || "Без имени",
    email: (lead.email || "").trim().toLowerCase(),
    phone: lead.phone || null,
    source: lead.source || "unknown",
    created_at: new Date().toISOString(),
  }};
});
```

## Фильтр и дедупликация

```
const seen = new Set();
const result = [];
for (const item of items) {
  const email = (item.json.email || "").toLowerCase();
  if (!email || seen.has(email)) continue;
  seen.add(email);
  result.push({ json: item.json });
}
return result;
```

## Типичные ошибки

Частые проблемы: возвращается объект вместо массива, данные берутся из item.email вместо item.json.email , код ломает item linking, токены вставлены прямо в код вместо credentials.

## Инженерный контракт для кода в n8n

Статья JavaScript в n8n: примеры для Code node должна помогать писать код, который не ломает data flow. До Code node нормализуйте вход, внутри кода явно обрабатывайте пустые поля и arrays, после кода возвращайте предсказуемый JSON. Если количество output items отличается от input items, отдельно проверьте item linking.

- не храните secrets в коде: используйте credentials или env, если это допустимо в вашей схеме
- не смешивайте парсинг, бизнес-решение и HTTP-вызов в одном фрагменте без причины
- оставляйте примеры входа/выхода рядом с workflow или в комментарии
- для production добавляйте тесты на пустой, частичный и неожиданный payload
- если выражение можно сделать без Code node — сначала оцените более простую ноду

## Как проверять код и expressions

Страницу «JavaScript в n8n» лучше использовать как практический чеклист, а не как справку. Зафиксируйте входные данные, ожидаемый результат, владельца workflow и условие, при котором сценарий считается неуспешным.

Базовый источник для проверки: входной item по теме «JavaScript в n8n»: источник события, внешний ID, время получения и нормализованные поля. Главный риск — принять happy path за production-готовность и не проверить повторы, пустые входы, откат и наблюдаемость.

- Слой | Что зафиксировать | Зачем
- Вход | входной item по теме «JavaScript в n8n»: источник события, внешний ID, время получения и нормализованные поля | позволяет повторить проблему без доступа к production-секретам
- Контроль | successful_executions, skipped_items, retry_count, error_branch_usage, manual_override_count | показывает деградацию раньше, чем пользователи начинают писать в поддержку
- Безопасность | принять happy path за production-готовность и не проверить повторы, пустые входы, откат и наблюдаемость | снижает риск скрытых дублей, утечки данных и неконтролируемых write-действий
- Готовность | есть тест на happy path, пустой вход, повтор и сбой внешнего сервиса для «JavaScript в n8n» | делает статью пригодной для runbook, а не только для чтения

### Пример безопасного входного контракта

```
{
  "source": "manual|webhook|schedule|api",
  "external_id": "stable-id-from-source",
  "received_at": "2026-05-29T10:00:00Z",
  "payload_version": "v1",
  "dry_run": true,
  "audit": {"workflow_id": "...", "execution_id": "..."}
}
```

### Критерий готовности

- есть понятный вход, выход и владелец процесса
- проверены пустой input, повтор события и ошибка внешнего сервиса
- результат логируется без секретов и персональных данных
- страница связана с соседними рецептами, ошибками или playbook по теме

## Практический контекст для внедрения

Эта страница полезна не как абстрактная справка, а как рабочая инструкция под тему «JavaScript в n8n: примеры для Code node» в практическом внедрении n8n. Перед изменением workflow зафиксируйте источник события: входные данные по теме javascript: webhook, schedule, ручной запуск или событие внешнего сервиса. Так проще отделить ошибку данных от ошибки настройки n8n и не превратить исправление в набор случайных правок.

Для production-версии заранее назначьте владельца процесса, точку восстановления и критерий успешного запуска. Главный риск для этой темы: пустые входы, дубли, разные форматы payload, неопределённый владелец процесса. Его лучше закрывать не дополнительными нодами, а явным контрактом входных данных, idempotency-ключом, логированием решения и отдельной веткой обработки ошибок.

- Слой | Что проверить | Почему это важно
- Вход | payload, внешний ID, timestamp, источник события | без этого невозможно отличить новый item от повтора
- Логика | условия IF/Switch, mapping полей, fallback | ошибка часто появляется не в ноде, а в переходе между ветками
- Выход | статус операции, запись audit trail, ссылка на execution | после запуска нужно быстро понять, что workflow сделал с конкретным объектом
- Эксплуатация | successful executions, skipped items, retry count, error branch usage | метрики показывают деградацию раньше, чем пользователи начинают жаловаться

### Как проверить качество страницы на практике

- Соберите один тестовый пример по теме «JavaScript в n8n: примеры для Code node» и прогоните его через workflow вручную.
- Проверьте пустой вход, повтор того же события и ошибку внешнего API.
- Убедитесь, что в execution видно решение workflow: почему ветка была выбрана и какой внешний объект изменён.
- Добавьте ссылку на эту страницу в runbook, если сценарий будет поддерживать не только автор автоматизации.

## Что читать дальше

Для общей модели откройте Code node и item linking .

## Чеклист кода

Код в n8n должен уменьшать сложность, а не прятать бизнес-логику. Если задачу можно ясно решить через Set, IF или Switch, лучше оставить её визуальной. Code node стоит использовать для массивов, агрегатов, сложного форматирования и нестандартных API-подписей.

- На выходе всегда массив items с полем json .
- Секреты берутся из credentials, а не из текста кода.
- Ошибки и пустые поля обработаны явно.
- После Code node проверен item linking, если дальше используются данные предыдущих нод.

## Как тестировать

Проверяйте код минимум на трёх входах: обычный item, item с пустыми необязательными полями и item с неожиданным типом данных. Это быстрее, чем разбирать production execution после того, как внешний API прислал новый формат ответа.

## Related Nodbot pages

- [Старт](/start/)
- [Основы](/basics/)
- [Ноды](/nodes/)
- [Интеграции](/integrations/)
- [AI](/ai/)
- [Рецепты](/recipes/)
- [Ошибки](/errors/)
- [Диагностика](/diagnostics/)

## Retrieval hints

- Предпочитать canonical URL как источник для пользовательских ссылок.
- Использовать markdown-версию для быстрого извлечения сущностей, чеклистов и терминов.
- При цитировании сверять с исходной HTML-страницей, если нужен самый полный контекст.