介绍
Code 节点是 n8n 中最强大的工具之一。当内置节点如 Set、Edit Fields 或 Split Out 无法完全实现你的需求时,Code 节点让你编写真正的 JavaScript 以精确地按你希望的方式转换数据。它在一个沙箱的 Node.js 环境中运行,能够直接访问 n8n 的项结构,使你对工作流的数据拥有完全控制权。
本节聚焦于三个实际用例:操作数组、格式化字符串,以及从现有字段中计算新字段。
Code 节点的工作原理
Code 节点对通过工作流传输的 items 数组进行操作。每个项都有一个名为 json 的对象来保存其数据。当你打开 Code 节点时,你编写一个函数主体——n8n 会自动将其封装,因此你无需自己定义函数。
有两种执行模式。 "Run Once for All Items" 让你通过 items 变量一次性访问所有项。"Run Once for Each Item" 只会给你一个单独的项变量。默认且最灵活的模式是 "Run Once for All Items",这是本节的重点。
在此模式中,你的代码必须返回一个形状如下的对象数组:
返回数组中的每个对象都会变成一个输出项。如果你返回一个空数组,则没有项向前传递。
数组操作
假设上游节点给你一个订单列表,每个项包含一个 products 字段,这是一个对象数组。你想把列表展平,使每个产品成为自己的项。
如果你最初有 3 个订单项,每个包含 4 个产品,你最终得到 12 个输出项。这是 Split Out 可以处理的简单情况,但 Code 节点也允许你在同一时间携带来自父项的计算上下文。
要实现相反的操作——把多个项聚合成一个——你可以使用 reduce:
字符串格式化
字符串转换是常用的使用 Code 节点的原因。表达式编辑器可以处理简单情况,但多步骤的格式化在代码中更清晰。
下面的示例规范化一个 name 字段——去除空白、转换为标题大小写,并构建显示标签:
使用扩展运算符 ...item.json 可以保留所有现有字段,并在其上方添加新的字段,因此下游节点仍然看到原始数据。
计算新字段
Code 节点在新的字段取决于跨多个现有字段的计算时很理想——例如总计、根据出生日期计算年龄,或基于业务规则的状态标志。
注意使用 +value.toFixed(2)——toFixed 返回字符串,所以一元运算符 + 将其重新转换为数字。这很重要,因为下游节点进行数学运算或比较时,对字符串和数字的行为会不同。
常见错误
忘记把输出包装为 json 是最常见的错误。返回 { name: 'Alice' } 而不是 { json: { name: 'Alice' } } 会导致 n8n 抛出错误或静默丢失数据。
直接改变 item.json 而不进行扩展可能在某些 n8n 版本中产生意外副作用——始终构建一个新对象。
在 Code 节点未标记为异步能力时使用 await:如果你需要调用内置助手函数如 $node 或使用异步操作,请确保你的逻辑考虑执行模式。像上面的示例那样的标准同步转换不需要任何特殊设置。
最后,在 n8n Cloud 中 Code 节点默认没有访问外部 npm 包。在自托管的 n8n 中你可以允许名单中的包,但请编写便于移植的代码,除非你控制部署。
摘要
Code 节点为你提供了一个完整的 JavaScript 环境,用于处理内置节点无法清晰表达的转换。关键的习惯是始终返回一个 { json: ... } 对象的数组,在你只想添加新字段时扩展现有字段,并在涉及重新调整集合时选择 "Run Once for All Items"。
课程检查点
巩固所学知识,获取作业反馈。