Ir para o conteúdo
Promovaweb

Troque Function e Function Item pelo Code node

Revisado em

Antes de começar

Substituir cada node Function e Function Item por um Code node no modo equivalente, com a mesma saída.

  • Lista de workflows afetados no relatório de migração.
  • Instância de testes com cópia da sua instância.

Workflows com um node removido falham no n8n 3.0. Function e Function Item estão na lista. O substituto é o Code node, com o modo certo para cada um.

Qual modo usar

Node antigo Code node em
Function Run Once for All Items
Function Item Run Once for Each Item

O modo errado muda o resultado. O Function processava a lista inteira de uma vez. O Function Item processava um item por vez.

Procedimento

  1. Abra o relatório de migração e selecione o item dos nodes removidos para ver os workflows afetados.
  2. No ambiente de testes, abra um workflow e execute uma vez para guardar a saída atual do node antigo.
  3. Adicione um Code node ao lado, escolha o modo da tabela e cole o código do node antigo.
  4. Ajuste o código ao formato do Code node. No modo para todos os itens, ele recebe a lista com $input.all(). No modo por item, recebe o item atual com $input.item.
  5. Ligue o Code node no lugar do antigo e apague o node antigo.
  6. Execute de novo e compare a saída com a que você guardou.

O que mais conferir no código

  • No n8n 3.0, o tempo limite padrão das tarefas do Code node cai para 60 segundos. Códigos demorados precisam de ajuste em N8N_RUNNERS_TASK_TIMEOUT.
  • $evaluateExpression() sai do Code node para runners em modo inseguro. Avalie a expressão em um node Edit Fields antes do Code node.
  • Se o código buscava itens de outros nodes, confira o tutorial sobre $getPairedItem.

Quando o relatório oferece Migrate

Para alguns itens, o relatório traz o botão Migrate, que reescreve os nodes. O resultado vira uma nova versão do workflow, sem publicar. Teste antes de publicar: a migração automática troca os nodes, mas não confere a saída.

Confira o resultado

Com a mesma entrada, o Code node entrega o mesmo número de itens e os mesmos campos que o node antigo entregava.

Fontes e conferência

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