代码开发/Built_in_methods_and_variables
n8n 元数据#
用于操作 n8n 元数据的方法。 包括:
- 访问自托管 n8n 实例的 n8n 环境变量。
- 关于工作流(workflows)、执行(executions)和节点(nodes)的元数据。
- 关于实例 变量(Variables) 和 外部密钥(External secrets) 的信息。
Python 支持 你可以在代码节点(Code node)中使用 Python。它在表达式(expressions)中不可用。 JavaScriptPython
| 方法 | 说明 | 是否在代码节点中可用? |
|---|---|---|
$env | 包含 n8n 实例配置的 环境变量。 | ✅ |
$execution.customData | 设置和获取自定义执行数据。更多信息请参考 自定义执行数据。 | ✅ |
$execution.id | 当前工作流执行的唯一 ID。 | ✅ |
$execution.mode | 执行是自动触发还是手动运行工作流触发的。可能的值为 test 和 production。 | ✅ |
$execution.resumeUrl | 调用以恢复在 等待节点(Wait node) 处暂停的工作流的 webhook URL。 | ✅ |
$getWorkflowStaticData(type) | 查看 示例。静态数据在测试工作流时不会持久保存。必须激活工作流并通过触发器或 webhook 调用才能保存静态数据。此方法用于访问静态工作流数据。 | ✅ |
$("<node-name>").isExecuted | 检查某个节点是否已经执行。 | ✅ |
$itemIndex | 列表中某项的索引。 | ❌ |
$nodeVersion | 获取当前节点的版本。 | ✅ |
$prevNode.name | 当前输入来源节点的名称。使用合并节点(Merge node)时,请注意 $prevNode 始终使用第一个输入连接器。 | ✅ |
$prevNode.outputIndex | 当前输入来源的输出连接器索引。当上一个节点有多个输出(例如 If 或 Switch 节点)时使用。使用合并节点时,请注意 $prevNode 始终使用第一个输入连接器。 | ✅ |
$prevNode.runIndex | 生成当前输入的上一个节点的运行次数。使用合并节点时,请注意 $prevNode 始终使用第一个输入连接器。 | ✅ |
$runIndex | n8n 执行当前节点的次数。从零开始计数(第一次运行为 0,第二次为 1,依此类推)。 | ✅ |
$secrets | 包含有关你的 外部密钥(External secrets) 配置的信息。 | ✅ |
$vars | 包含当前活跃环境中可用的 变量(Variables)。 | ✅ |
$version | 节点版本。 | ❌ |
$workflow.active | 工作流是否处于激活状态(true 表示激活,false 表示未激活)。 | ✅ |
$workflow.id | 工作流 ID。 | ✅ |
$workflow.name | 工作流名称。 | ✅ |
| 方法 | 说明 | |
| --- | --- | |
_env | 包含 n8n 实例配置的 环境变量。 | |
_execution.customData | 设置和获取自定义执行数据。更多信息请参考 自定义执行数据。 | |
_execution.id | 当前工作流执行的唯一 ID。 | |
_execution.mode | 执行是自动触发还是手动运行工作流触发的。可能的值为 test 和 production。 | |
_execution.resumeUrl | 调用以恢复在 等待节点(Wait node) 处暂停的工作流的 webhook URL。 | |
_getWorkflowStaticData(type) | 查看 示例。静态数据在测试工作流时不会持久保存。必须激活工作流并通过触发器或 webhook 调用才能保存静态数据。此方法用于访问静态工作流数据。 | |
_("<node-name>").isExecuted | 检查某个节点是否已经执行。 | |
_nodeVersion | 获取当前节点的版本。 | |
_prevNode.name | 当前输入来源节点的名称。使用合并节点(Merge node)时,请注意 _prevNode 始终使用第一个输入连接器。 | |
_prevNode.outputIndex | 当前输入来源的输出连接器索引。当上一个节点有多个输出(例如 If 或 Switch 节点)时使用。使用合并节点时,请注意 _prevNode 始终使用第一个输入连接器。 | |
_prevNode.runIndex | 生成当前输入的上一个节点的运行次数。使用合并节点时,请注意 _prevNode 始终使用第一个输入连接器。 | |
_runIndex | n8n 执行当前节点的次数。从零开始计数(第一次运行为 0,第二次为 1,依此类推)。 | |
_secrets | 包含有关你的 外部密钥(External secrets) 配置的信息。 | |
_vars | 包含当前活跃环境中可用的 变量(Variables)。 | |
_workflow.active | 工作流是否处于激活状态(true 表示激活,false 表示未激活)。 | |
_workflow.id | 工作流 ID。 | |
_workflow.name | 工作流名称。 |