Ir para o conteúdo
Promovaweb

Quando usar o Code node

Revisado em

Antes de começar

Escolher entre o Code node e os nodes de transformação e configurar o modo certo quando o código for necessário.

  • Noções de JavaScript.

O Code node roda JavaScript como um passo do workflow. Ele resolve transformações que os outros nodes não cobrem. Em troca, o workflow fica mais difícil de ler sem conhecer JavaScript. A documentação também aponta o Code node como um dos nodes que mais consomem memória.

Antes de escrever código

Confira se um node pronto resolve: Edit Fields para criar e renomear campos, Filter e If para separar itens, Aggregate, Split Out, Sort, Limit, Remove Duplicates e Summarize para reorganizar listas. Expressões dentro desses nodes resolvem boa parte dos cálculos e formatações.

Os dois modos

Modo Quando usar
Run Once for All Items (padrão) O código precisa ver a lista inteira, por exemplo para somar ou agrupar
Run Once for Each Item O código trata cada item sozinho, por exemplo para formatar um campo

Limites que vale conhecer

  • Em instalação própria, módulos npm externos só funcionam depois de liberados por configuração.
  • O suporte a Python com Pyodide saiu no n8n 2.0.
  • No n8n 3.0, o tempo limite padrão das tarefas do Code node cai de 5 minutos para 1 minuto. Códigos demorados precisam de ajuste na variável N8N_RUNNERS_TASK_TIMEOUT.

Workflows com Function

Os nodes Function e Function Item saem no n8n 3.0. O substituto é o Code node: Run Once for All Items no lugar de Function e Run Once for Each Item no lugar de Function Item. Teste a saída depois da troca, porque o modo errado muda o número de itens.

Confira o resultado

O Code node do seu teste entrega o mesmo número de itens esperado e não depende de um módulo indisponível na instância.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.