n8n 中文文档

引用之前的节点

在 n8n 中处理数据时,您通常需要引用工作流程中当前节点或先前节点的信息。

的常用引用方式

最常用的访问数据的方法是:

  • $json:从当前输入项访问JSON数据
  • $('<node-name>').item.json $('<节点名称>').item.json:从前一个节点中的链接项访问JSON数据
  • $('<node-name>').item.binary:从前一个节点中的链接项访问二进制数据(文件、图像)

其他引用方法

这些方法在表达式和代码节点中都有效:

方法 描述
$binary 从当前输入项访问二进制数据
$input.item 当前正在处理的输入项
$('<node-name>').first() 获取指定节点的第一项
$('<node-name>').last() 获取指定节点的最后一项
$('<node-name>').all() 获取指定节点的所有项目

当前节点输入

处理当前节点输入的方法。某些方法和变量在“代码”节点中不可用。

提示

Python support Python支持

您可以在代码节点中使用Python。它在表达式中不可用。

JavaScript

方法 描述 在代码节点中可用吗?
$binary $input.item.binary 的简写。从节点传入的二进制数据 ❌
$input.item 正在处理的当前节点的输入项。有关配对项目和项目链接的更多信息,请参阅项目链接。 ✅
$input.all() 当前节点中的所有输入项。 ✅
$input.first() 当前节点中的第一个输入项。 ✅
$input.last() 当前节点中的最后一个输入项。 ✅
$input.params 包含前一个节点的查询设置的对象。这包括其运行的操作、结果限制等数据。 ✅
$json $input.item.json 的简写。从节点传入 JSON 数据。有关项目结构的信息,请参阅数据结构。 ✅(为每个项目运行一次时)
$input.context.noItemsLeft 布尔值。仅在使用“循环项目”节点时可用。提供有关节点中发生的情况的信息。使用它来确定节点是否仍在处理项目。 ✅

Python

方法 描述
_input.item 正在处理的当前节点的输入项。有关配对项目和项目链接的更多信息,请参阅项目链接。
_input.all() 当前节点中的所有输入项。
_input.first() 当前节点中的第一个输入项。
_input.last() 当前节点中的最后一个输入项。
_input.params 包含前一个节点的查询设置的对象。这包括其运行的操作、结果限制等数据。
_json _input.item.json 的简写。从节点传入 JSON 数据。有关项目结构的信息,请参阅数据结构。当您将 Mode 模式 设置为 Run Once for Each Item 每个项目运行一次 时可用。
_input.context.noItemsLeft 布尔值。仅在使用“循环项目”节点时可用。提供有关节点中发生的情况的信息。使用它来确定节点是否仍在处理项目。

其他节点的输出

使用其他节点的输出的方法。某些方法和变量在“代码”节点中不可用。

方法 描述 在代码节点中可用吗?
$("<node-name>").all(branchIndex?, runIndex?) 返回给定节点的所有项目。如果未给出 branchIndex,它将默认为将 node-name 与使用表达式或代码的节点连接起来的输出。 ✅
$("<node-name>").first(branchIndex?, runIndex?) 给定节点输出的第一项。如果未给出 branchIndex,它将默认为将 node-name 与使用表达式或代码的节点连接起来的输出。 ✅
$("<node-name>").last(branchIndex?, runIndex?) 给定节点输出的最后一项。如果未给出 branchIndex,它将默认为将 node-name 与使用表达式或代码的节点连接起来的输出。 ✅
$("<node-name>").item 链接的项目。这是指定节点中用于生成当前项目的项目。有关项目链接的更多信息,请参阅项目链接。 ✅
$("<node-name>").item.binary 链接项中的二进制数据,按二进制属性名称作为键(默认为 data)。有关可用属性,请参阅 BinaryFile。 ✅
$("<node-name>").params 包含给定节点的查询设置的对象。这包括其运行的操作、结果限制等数据。 ✅
$("<node-name>").context 布尔值。仅在使用“循环项目”节点时可用。提供有关节点中发生的情况的信息。使用它来确定节点是否仍在处理项目。 ✅
$("<node-name>").itemMatching(currentNodeInputIndex) 如果您需要从输入项进行追溯,请在代码节点中使用 $("<node-name>").item 代替。 ✅

引用上一个节点中的二进制数据

$('<node-name>').item 会返回完整的链接项,因此你可以像读取 JSON 数据一样读取其中的二进制数据:使用 .item.json 读取该项的 JSON 对象,使用 .item.binary 读取它的二进制数据(文件、图像和其他附件)。

一个数据项可以包含多个二进制属性,每个属性都有自己的名称,因此 .item.binary 返回的是这些属性组成的对象,而不是单个值。大多数节点会把二进制数据输出到名为 data 的属性下,但具体名称取决于上游节点。每个二进制属性都是一个 BinaryFile,包含 fileName、mimeType 和 fileExtension 等字段。

例如,要获取 HTTP Request 节点生成的 data 二进制属性的文件名:

{{ $('HTTP Request').item.binary.data.fileName }}

有关二进制数据以及会生成二进制数据的节点,请参阅二进制数据。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。