O que é o Code node
O Code node é o Node do n8n que executa JavaScript dentro de um workflow. Ele recebe os itens da etapa anterior e devolve os itens transformados para o próximo Node.
Você usa o código quando a transformação precisa de lógica que os Nodes prontos não configuram. A mesma função que seria escrita em uma aplicação roda dentro do fluxo, no formato do n8n.
Entrada, saída e erro
O Code node recebe o conteúdo como itens e devolve a lista no formato esperado. A saída precisa ser conferida, porque um campo ausente ou um tipo errado quebra o Node seguinte.
Tratamento de erro
Um erro não tratado dentro do Code node interrompe a execução daquele item. Você pode capturar a exceção e devolver um item com a indicação do problema, para o fluxo decidir o próximo passo.
A escolha depende do uso. Um pagamento com falha merece parar e ser investigado, enquanto uma leitura que falha para um item pode ser registrada e seguir com os demais.
Código simples e conferido
O código dentro do fluxo vale o mesmo cuidado do código da aplicação. Uma transformação pequena e legível é mais fácil de corrigir do que um trecho extenso com várias responsabilidades.
Para revisar um Code node e conferir a transformação durante a execução, o Desenvolvimento Colaborativo da Dev Side Studio permite ajustar o fluxo ao vivo.
Dúvidas frequentes
Perguntas frequentes sobre Code node
- Code node substitui os Nodes prontos?
- Não. Um Node pronto economiza código quando a função existe. O Code node entra para transformar um conteúdo ou montar um retorno que nenhum Node configurável cobre.
- O que o Code node recebe e devolve?
- Ele recebe os itens da etapa anterior e devolve os itens transformados. O retorno precisa respeitar o formato esperado pelo próximo Node, e a saída vazia ou errada interrompe o uso.
- Erro dentro do Code node para o fluxo?
- Um erro não tratado falha a execução daquele item. Você pode tratar a exceção e devolver um item com a indicação do problema em vez de interromper todo o fluxo.
Para continuar
Recursos relacionados
Documentação
n8n: Code node
Explica a execução de JavaScript no fluxo, a entrada e a saída esperada.
Abrir recursoDocumentação
n8n: documentação
Guia da plataforma, dos Nodes e do comportamento de cada etapa.
Abrir recursoAplicação na formação
n8n Experts
O Code node resolve transformações e comportamentos que os Nodes prontos do n8n não cobrem.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.