数组#
一份参考文档，列出了用于在 表达式 中支持数组数据转换的内置便捷函数。
表达式中的 JavaScript 你可以在表达式中使用任意 JavaScript。更多信息请参见 表达式。
average(): 数值 #
返回数组中元素的平均值。
chunk(size: 数值): 数组 #
将数组拆分为长度为 size 的多个块。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| size | 是 | Number |
每个块的大小。
compact(): 数组 #
从数组中移除空值（如 null, undefined, "", NaN 等）。
difference(arr: 数组): 数组 #
比较两个数组，返回在基础数组中存在但不在 arr 中的元素。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| arr | 是 | Array |
用于与基础数组进行比较的数组。
intersection(arr: 数组): 数组 #
比较两个数组，返回在基础数组和 arr 中都存在的元素。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| arr | 是 | Array |
用于与基础数组进行比较的数组。
first(): 数组项 #
返回数组的第一个元素。
isEmpty(): 布尔值 #
检查数组是否没有任何元素。
isNotEmpty(): 布尔值 #
检查数组是否包含元素。
last(): 数组项 #
返回数组的最后一个元素。
max(): 数值 #
返回数组中的最大值。
merge(arr: 数组): 数组 #
通过合并每个元素的键值对，将两个对象数组合并为一个数组。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| arr | 是 | Array |
要合并到基础数组中的数组。
min(): 数值 #
获取仅包含数字的数组中的最小值。
pluck(fieldName?: 字符串): 数组 #
返回一个对象数组，其中的对象只保留指定字段名对应的键值对。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| fieldName | 否 | String |
想要提取的键名。可以输入多个键名，用逗号分隔。
randomItem(): 数组项 #
从数组中随机返回一个元素。
removeDuplicates(key?: 字符串): 数组 #
从数组中移除重复项。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| key | 否 | String |
用于检测重复项的键名，或以逗号分隔的多个键名列表。
renameKeys(from: 字符串, to: 字符串): 数组 #
重命名数组中所有匹配的键。可以通过传入一系列以逗号分隔的字符串来重命名多个键，格式为：旧键名, 新键名。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| from | 是 | String |
| to | 是 | String |
- from: 要重命名的键。
- to: 新的键名。
smartJoin(keyField: 字符串, nameField: 字符串): 数组 #
作用于一个对象数组，每个对象包含键值对。创建一个新的对象，其键值对由原对象中指定的两个字段构成：keyField 的值作为新键，nameField 的值作为新值。自动移除不匹配或为空的值，并在连接前去除空白字符。
函数参数#
| 参数名 | 是否必需 | 类型 |
|---|---|---|
| keyField | 是 | String |
| nameField | 是 | String |
- keyField: 用作新键的字段。
- nameField: 用作新值的字段。
示例
基本用法
1
2
3
4| ``` // 输入 {{[{"type":"fruit","name":"apple"},{"type":"vegetable","name":"carrot"}].smartJoin("type","name")}} // 输出 [Object:{"fruit":"apple","vegetable":"carrot"}]
---|---
* * *
### sum(): 数字 [#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#array-sum "永久链接")
返回可解析数字数组中所有值的总和。
* * *
### toJsonString(): 字符串 [#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#array-toJsonString "永久链接")
将数组转换为 JSON 字符串。等同于 `JSON.stringify`。
* * *
### union(arr: 数组): 数组 [#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#array-union "永久链接")
连接两个数组并去除重复项。
#### 函数参数[#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#function-parameters_8 "永久链接")
arrRequiredArray
与基础数组进行比较的数组。
* * *
### unique(key?: 字符串): 数组 [#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#array-unique "永久链接")
从数组中移除重复元素。
#### 函数参数[#](https://docs.n8n.io/code/builtin/data-transformation-functions/arrays/#function-parameters_9 "永久链接")
keyOptionalString
用于检查重复项的键，或以逗号分隔的多个键（keys）。
* * *