n8n 元数据

处理 n8n 元数据的方法。

包括：

• 访问自托管 n8n 的环境变量。
• 工作流、执行和节点的元数据。
• 实例变量和外部机密的信息。

信息

Python 支持

可以在 Code 节点中使用 Python，但表达式不支持 Python。

JavaScript

方法	说明	Code 节点中是否可用
$env	包含 n8n 实例配置的环境变量。	✅
$execution.customData	设置和获取自定义执行数据。更多信息请参阅自定义执行数据。	✅
$execution.id	当前工作流执行的唯一 ID。	✅
$execution.mode	执行由自动触发还是手动运行工作流启动，可选值为 test 和 production。	✅
$execution.resumeUrl	用于恢复在 Wait 节点处等待的工作流的 Webhook URL。	✅
$getWorkflowStaticData(type)	访问工作流静态数据。测试工作流时，静态数据不会持久保存：需发布工作流，并通过触发器或 Webhook 运行才能保存。要在多次执行之间持久保存数据，可考虑改用数据表。查看示例。	✅
$("<node-name>").isExecuted	检查节点是否已经执行。	✅
$itemIndex	数据项在列表中的索引。	❌
$nodeVersion	获取当前节点的版本。	✅
$prevNode.name	当前输入来源节点的名称。使用 Merge 节点时，请注意 $prevNode 始终使用第一个输入连接点。	✅
$prevNode.outputIndex	当前输入来源的输出连接点索引。前一节点有多个输出时使用，例如 If 或 Switch 节点。使用 Merge 节点时，请注意 $prevNode 始终使用第一个输入连接点。	✅
$prevNode.runIndex	前一节点生成当前输入时对应的运行。使用 Merge 节点时，请注意 $prevNode 始终使用第一个输入连接点。	✅
$runIndex	n8n 已执行当前节点的次数，从零开始计数：第一次运行是 0，第二次是 1，依此类推。	✅
$secrets	包含外部机密配置信息。	❌
$vars	包含当前环境可用的变量。	✅
$version	节点版本。	❌
$workflow.active	工作流是否处于活跃状态：true 表示是，false 表示否。	✅
$workflow.id	工作流 ID。	✅
$workflow.name	工作流名称。	✅

Python（原生）

方法	说明
_items	包含“Run once for all items（为所有数据项运行一次）”模式下的传入数据项。
_item	包含“Run once for each item（为每个数据项运行一次）”模式下正在遍历的数据项。
_query	在 Code Tool 中，包含 AI Agent 调用工具时传入的输入字符串。可用于“Run once for all items（为所有数据项运行一次）”模式。

Python（Pyodide，已弃用）

从 n8n 1.113.2 起，Python（Pyodide）支持已弃用。请改用原生 Python。

方法	说明
_env	包含 n8n 实例配置的环境变量。
_execution.customData	设置和获取自定义执行数据。更多信息请参阅自定义执行数据。
_execution.id	当前工作流执行的唯一 ID。
_execution.mode	执行由自动触发还是手动运行工作流启动，可选值为 test 和 production。
_execution.resumeUrl	用于恢复在 Wait 节点处等待的工作流的 Webhook URL。
_getWorkflowStaticData(type)	访问工作流静态数据。测试工作流时，静态数据不会持久保存：需发布工作流，并通过触发器或 Webhook 运行才能保存。要在多次执行之间持久保存数据，可考虑改用数据表。查看示例。
_("<node-name>").isExecuted	检查节点是否已经执行。
_nodeVersion	获取当前节点的版本。
_prevNode.name	当前输入来源节点的名称。使用 Merge 节点时，请注意 _prevNode 始终使用第一个输入连接点。
_prevNode.outputIndex	当前输入来源的输出连接点索引。前一节点有多个输出时使用，例如 If 或 Switch 节点。使用 Merge 节点时，请注意 _prevNode 始终使用第一个输入连接点。
_prevNode.runIndex	前一节点生成当前输入时对应的运行。使用 Merge 节点时，请注意 _prevNode 始终使用第一个输入连接点。
_runIndex	n8n 已执行当前节点的次数，从零开始计数：第一次运行是 0，第二次是 1，依此类推。
_secrets	包含外部机密配置信息。
_vars	包含当前环境可用的变量。
_workflow.active	工作流是否处于活跃状态：true 表示是，false 表示否。
_workflow.id	工作流 ID。
_workflow.name	工作流名称。

相关资源

• 使用内置快捷方法
• JMESPath
• HTTP 节点
• LangChain Code 节点