n8n 中文文档

表达式参考

以下是一些常用表达式。更完整的列表见下方。

分类 表达式 描述
访问当前输入项数据 $json 当前项目的 JSON 数据
$json.fieldName 当前项目的字段
$binary 当前项目的二进制数据
访问之前的节点数据 $("NodeName").first() 节点中的第一项
$("NodeName").item 节点的链接项。有关更多信息,请参阅项目链接。
$("NodeName").all() 节点的所有项目
$("NodeName").last() 节点的最后一项
日期/时间 $now 当前日期和时间
$today 今天的日期
$now.toFormat("yyyy-MM-dd") 将当前日期格式化为字符串
条件句 $if(condition, "true", "false") 当条件为 true 或 false 时返回值的辅助函数
condition ? true : false 三元运算符:如果条件为 true,则返回一个值;如果条件为 false,则返回另一个值
$ifEmpty(value, defaultValue) 辅助函数接受两个参数并测试第一个参数以检查它是否为空,然后返回该参数(如果不为空)或第二个参数(如果第一个参数为空)。如果第一个参数是 undefined、null、空字符串 ''、value.length 返回 false 的数组或 Object.keys(value).length 返回 false 的对象,则第一个参数为空。
字符串方法 text.toUpperCase() 转换为大写
text.toLowerCase() 转换为小写
text.includes("foo") 检查文本是否包含搜索词
text.extractEmail() 从文本中提取电子邮件
数组方法 array.length 获取数组长度
array.join(", ") 使用逗号分隔符连接数组元素
array.filter(x => x <= 20) 根据过滤条件过滤数组项
array.map(x => x.id) 变换数组的项

浏览下方的表格,按数据类型查找相应的方法。点击方法名可查看详细文档。

本节内容

  • 数组:Description: 向数组末尾添加新元素。类似于 push(),但返回修改后的数组。建议使用展开语法代替(参见示例)。
  • 二进制文件:Description: 文件存储目录的路径。用于区分不同目录中同名的文件。如果 n8n 配置为将文件存储在数据库中,则不会设置此值。
  • 布尔值:Description 描述: 如果布尔值为 false、null 或 undefined,则返回 true;如果布尔值为 true,则返回 false。
  • 自定义数据:Description: 返回存储在指定键下的自定义执行数据。更多信息。
  • 日期:Description: 说明: 将 JavaScript 日期转换为 Luxon DateTime。
  • 日期时间:Description: 月份中的日期(1-31)。
  • ExecData 执行数据:Description: 设置和获取自定义执行数据(例如用于筛选执行记录)。您也可以使用 'Execution Data' 节点完成此操作。更多信息。
  • HTTPResponse 响应:Description: 上一次 HTTP 调用的响应体。仅在 'HTTP Request' 节点中可用。
  • 数据项:Description: 说明: 返回该项目包含的任何二进制数据。
  • NodeInputData 节点输入数据:Description: 返回当前节点的输入数据项数组。
  • NodeOutputData 节点输出数据:Description: 返回节点的输出数据项数组。
  • 数字:Description: 返回数字的绝对值,即移除负号。
  • 对象:Description: 移除所有值为空的字段,即值为 null 或 "" 的字段。
  • PrevNodeData 上一节点数据:Description: 当前输入来源节点的名称。
  • 根级变量:Description: 返回指定节点的数据。
  • 字符串:Description: 将 base64 编码的字符串转换为纯文本。
  • WorkflowData 工作流数据:Description: 说明: 工作流程是否处于活动状态。

数组

如果需要所有匹配的元素,请使用 filter()。

与 split() 相反。

另请参阅 slice() 和 append()。

二进制文件

布尔值

  • Boolean.isEmpty()

    如果布尔值为 false、null 或 undefined,则返回 true;如果布尔值为 true,则返回 false。

  • Boolean.isNotEmpty()

    如果布尔值为 true,则返回 true;如果布尔值为 false、null 或 undefined,则返回 false。此方法与 isEmpty() 相反。

  • Boolean.toNumber()

    将 true 转换为 1,false 转换为 0

  • Boolean.toString()

    将 true 转换为字符串 'true',false 转换为字符串 'false'

自定义数据

日期

  • Date.toDateTime()

    将 JavaScript Date 转换为 Luxon DateTime。DateTime 包含相同的信息,但更易于操作。

日期时间

ExecData

HTTP响应

商品

NodeInputData

NodeOutputData

编号

对象

PrevNodeData

如果有多个输入连接器(例如在 'Merge' 节点中),始终使用当前节点的第一个输入连接器。

  • outputIndex 输出索引

    当前输入来自的输出连接器的索引。当前置节点有多个输出时使用(例如 'If' 或 'Switch' 节点)。

如果有多个输入连接器(例如在 'Merge' 节点中),始终使用当前节点的第一个输入连接器。

如果有多个输入连接器(例如在 'Merge' 节点中),始终使用当前节点的第一个输入连接器。

根

使用工作流的时区(可在工作流设置中更改)。

  • $pageCount

    节点已获取的结果页数。仅在 'HTTP Request' 节点中可用。

  • $parameter $参数

    当前节点的配置设置。这些是你在节点 UI 中填写的参数(例如其操作)。

  • $prevNode

    关于当前输入来自的节点的信息。

在 'Merge' 节点中,始终使用第一个输入连接器。

  • $request $请求

    节点上次运行时发送的请求对象。仅在 'HTTP Request' 节点中可用。

  • $response $响应

    上次 HTTP 调用返回的响应。仅在 'HTTP Request' 节点中可用。

  • $runIndex

    当前节点执行中当前运行的索引。从 0 开始。

  • $secrets $秘密

    来自外部密钥保管库的密钥(如果已配置)。密钥值永远不会显示给用户。仅在凭证字段中可用。

  • $today 今天$

    表示当天午夜开始时刻的 DateTime。

使用实例的时区(除非在工作流设置中被覆盖)。

字符串

如果字符串还包含其他内容,请先尝试使用 extractEmail() 或 extractUrl()。

如果字符串还包含其他内容,请先尝试使用 extractUrl()。

如需检查文本是否存在,请考虑使用 includes()。

要替换所有出现的位置,请使用 replaceAll()。

与对数组使用 join() 相反。

要解析其他格式,请使用 DateTime.fromFormat()。

  • String.toJsonString()

    准备将字符串插入 JSON 对象。转义所有引号和特殊字符(例如换行符),并用引号包裹字符串。

与 JavaScript 的 JSON.stringify() 相同。

  • String.toLowerCase()

    将字符串中的所有字母转换为小写

  • String.toNumber()

    将表示数字的字符串转换为数字。如果字符串不以有效数字开头则抛出错误。

  • String.toSentenceCase()

    将字符串的大小写更改为句子大小写。每个句子的第一个字母大写,其他字母小写。

  • String.toSnakeCase()

    将字符串的格式更改为蛇形命名法。空格和连字符替换为 _,符号被移除,所有字母转为小写。

  • String.toTitleCase()

    将字符串的大小写更改为标题大小写。每个单词的第一个字母大写,其他字母保持不变。短介词和连词不大写(例如 'a'、'the')。

  • String.toUpperCase()

    将字符串中的所有字母转换为大写

  • String.trim() 修剪()

    移除字符串两端的空白字符。空白字符包括换行符、制表符、空格等。

  • String.urlDecode(allChars?)

    解码 URL 编码的字符串。将 %XX 形式的字符代码替换为其对应的字符。

  • String.urlEncode(allChars?)

    对字符串进行编码以便在 URL 中使用。空格和特殊字符被替换为 %XX 形式的代码。

工作流程数据

相关资源

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