SuperAPI AI 工具集

n8n-code-javascript

写作与研究

查看项目

更新于 10-15 20:30

技能介绍

用途:指导在 n8n 的 Code 节点中编写 JavaScript,处理数据转换、聚合与自定义逻辑。

主要能力:

  • 执行模式:推荐“Run Once for All Items”(一次处理全部条目),用 $input.all() 访问;特殊场景用“Run Once for Each Item”,用 $input.item。前者性能明显更优。
  • 数据访问:$input.all()、$input.first().json、$input.item、$node["Name"].json;字段须经 .json 访问。
  • 返回格式:规范形式为 [{json: {...}}];All Items 模式下裸对象会被自动包装,但返回字符串/数字/null 会报错。
  • Webhook 数据在 $json.body 下,而非 $json 直接访问。
  • 内置:this.helpers.httpRequest()(无认证)、DateTime(Luxon)、$jmespath()、$getWorkflowStaticData()。

限制:$helpers 全局未定义;httpRequestWithAuthentication 被禁用;$env 在 N8N_BLOCK_ENV_ACCESS_IN_NODE=true 时不可用;require() 仅限实例白名单模块。认证请求建议改用 HTTP Request 节点。

适用场景:跨条目聚合、复杂转换、递归、API 响应解析、多步条件。简单映射/过滤/条件应优先用 Set、Filter、IF 等原生节点;加密与 XML 解析有原生节点。

常见错误:空代码或缺少 return、在代码中误用 {{ }}、缺少空值检查、Webhook 嵌套、返回原始类型。建议先校验输入、用 try-catch、优先数组方法、尽早过滤。