n8n 中文文档

数组

Array.append() 追加()

Description: 向数组末尾添加新元素。类似于 push(),但返回修改后的数组。建议使用展开语法代替(参见示例)。

Syntax: 语法: Array.append(elem1, elem2?, ..., elemN?)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • elem1 (any) - 要追加的第一个元素
  • elem2 (any) - 可选 - 要追加的第二个元素
  • elemN (any) - 可选 - 要追加的第 N 个元素

Examples: 示例:

javascript // arr = ['forget', 'me'] arr.append('not') //=> arr = ['forget', 'me', 'not']

```javascript // arr = [9, 0, 2] arr.append(1, 0) //=> [9, 0, 2, 1, 0]

// Consider using spread syntax instead [...arr, 1, 0] //=> [9, 0, 2, 1, 0] ```

Array.average() 平均()

Description: 返回数组中数字的平均值。如果包含非数字元素则抛出错误。

Syntax: 语法: Array.average()

Returns: 返回: 编号

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = [12, 1, 5] arr.average() //=> 6

Array.chunk() 块()

Description: 将数组拆分为由子数组组成的数组,每个子数组包含指定长度的元素

Syntax: 语法: Array.块(长度)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • length (Number) - 每个分块中的元素数量

Examples: 示例:

javascript // arr = [1, 2, 3, 4, 5, 6] arr.chunk(2) //=> [ [1,2], [3,4], [5,6] ]

Array.compact() 紧凑()

Description: 移除数组中的所有空值。null、"" 和 undefined 被视为空值。

Syntax: 语法: Array.compact()

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = [2, null, 1, ""] arr.compact() //=> [2, 1]

Array.concat() 连接()

Description: 将一个或多个数组连接到基础数组的末尾

Syntax: 语法: Array.concat(array2, array3?, ... arrayN?)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • array2 (Array) - 要连接到基础数组末尾的第一个数组
  • array3 (Array) - 可选 - 要连接到基础数组末尾的第二个数组
  • arrayN (Array) - 可选 - 要连接到基础数组末尾的第 N 个数组

Examples: 示例:

javascript // arr1 = ['Nathan', 'Jan'] arr1.concat(['Steve', 'Bill']) // ['Nathan', 'Jan', 'Steve', 'Bill']

javascript // arr1 = [5, 4] // arr2 = [100, 101] // arr3 = ['a', 'b'] arr1.concat(arr2, arr3) // [5, 4, 100, 101, 'a', 'b']

Array.difference() 差异()

Description: 比较两个数组。返回基础数组中不存在于 otherArray 中的所有元素。

Syntax: 语法: Array.差异(otherArray)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • otherArray (Array) - 用于与基础数组进行比较的数组

Examples: 示例:

javascript // arr = [1, 2, 3] arr.difference([2, 3]) //=> [1]

Array.filter() 过滤器()

Description: 返回一个仅包含满足条件的元素的数组。条件是一个返回 true 或 false 的函数。

Syntax: 语法: Array.filter(函数(元素,索引?,数组?), thisValue?)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • function() (function) - 对每个数组元素执行的函数。如果返回 true,则保留该元素。建议使用箭头函数表示法以节省空间。
  • element (any) - 当前元素的值
  • index (Number) - 可选 - 当前元素在数组中的位置(从 0 开始)
  • array (Array) - 可选 - 正在处理的数组。很少需要使用。
  • thisValue (any) - 可选 - 作为函数 this 值传递的值。很少需要使用。

Examples: 示例:

javascript // Keep ages over 18 (using arrow function notation): // ages = [12, 33, 16, 40] ages.filter(age => (age > 18)) //=> [33, 40]

```javascript // Keep names under 5 letters long (using arrow function notation): // names = ['Nathan', 'Bob', 'Sebastian'] ages.filter(age => (age.length < 5)) //=> ["Bob"]

// Or using traditional function notation: ages.filter(function(age){return age.length < 5}) //=> ["Bob"] ```

javascript // Keep numbers at odd indexes // nums = [1, 7, 3, 10, 5] ages.filter((num, index) => {return index%2 != 0}) //=> [7, 10]

Array.find() 查找()

Description: 返回数组中第一个满足条件的元素。条件是一个返回 true 或 false 的函数。如果没有找到匹配项,则返回 undefined。

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

Syntax: 语法: Array.find(函数(元素,索引?,数组?), thisValue?)

Returns: 返回: 任意

Source: 来源: JavaScript 函数

Parameters: 参数:

  • function() (function) - 对每个数组元素执行的函数。一旦返回 true,该元素将被返回。建议使用箭头函数表示法以节省空间。
  • element (any) - 当前元素的值
  • index (Number) - 可选 - 当前元素在数组中的位置(从 0 开始)
  • array (Array) - 可选 - 当前元素所在的数组。很少需要使用。
  • thisValue (any) - 可选 - 作为函数 this 值传递的值。很少需要使用。

Examples: 示例:

javascript // Find first age over 18 (using arrow function notation): // ages = [12, 33, 16, 40] ages.find(age => (age > 18)) //=> 33

```javascript // Find first name under 5 letters long (using arrow function notation): // names = ['Nathan', 'Bob', 'Sebastian'] ages.find(age => (age.length < 5)) //=> 'Bob'

// Or using traditional function notation: ages.find(function(age){return age.length < 5}) //=> 'Bob' ```

Array.first() 首先()

Description: 返回数组的第一个元素

Syntax: 语法: Array.first()

Returns: 返回: 任意

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = ['quick', 'brown', 'fox'] arr.first() //=> 'quick'

Array.includes() 包含()

Description: 如果数组包含指定的元素,则返回 true

Syntax: 语法: Array.includes(元素,开始?)

Returns: 返回: 布尔值

Source: 来源: JavaScript 函数

Parameters: 参数:

  • element (any) - 要在数组中搜索的值
  • start (Number) - 可选 - 开始搜索的索引位置

Examples: 示例:

javascript // names = ["Bob", "Bill", "Nat"]; names.includes("Nat") //=> true names.includes("Nathan") //=> false

Array.indexOf()

Description: 返回数组中第一个匹配元素的位置,如果未找到该元素则返回 -1。位置从 0 开始。

Syntax: 语法: Array.indexOf(元素,开始?)

Returns: 返回: 编号

Source: 来源: JavaScript 函数

Parameters: 参数:

  • element (any) - 要查找的值
  • start (Number) - 可选 - 开始搜索的索引位置

Examples: 示例:

javascript // names = ["Bob", "Bill", "Nat"]; names.indexOf("Nat") //=> 2

javascript // names = ["Bob", "Bill", "Nat"]; names.indexOf("Nathan") //=> -1

Array.intersection() 交叉点()

Description: 比较两个数组。返回基础数组中同时存在于另一个数组中的所有元素。

Syntax: 语法: Array.intersection(otherArray)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • otherArray (Array) - 用于与基础数组进行比较的数组

Examples: 示例:

javascript // arr = [1, 2] arr.intersection([2, 3]) //=> [2]

Array.isEmpty()

Description 描述: 如果数组没有元素,或值为 null 或 undefined,则返回 true

Syntax: 语法: Array.isEmpty()

Returns: 返回: 布尔值

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = [] arr.isEmpty() //=> true

javascript // arr = ['quick', 'brown', 'fox'] arr.isEmpty() //=> false

Array.isNotEmpty()

Description: 如果数组至少有一个元素,则返回 true

Syntax: 语法: Array.isNotEmpty()

Returns: 返回: 布尔值

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = ['quick', 'brown', 'fox'] arr.isNotEmpty() //=> true

javascript // arr = [] arr.isNotEmpty() //=> false

Array.join() 加入()

Description: 将数组的所有元素合并为一个字符串,元素之间可使用可选的分隔符。

与 split() 相反。

Syntax: 语法: Array.join(分隔符?)

Returns: 返回: 字符串

Source: 来源: JavaScript 函数

Parameters: 参数:

  • separator (String) - 可选 - 要在每个元素之间插入的字符

Examples: 示例:

javascript // arr = ['Wind', 'Water', 'Fire'] a.join(" + ") //=> 'Wind + Water + Fire'

javascript // arr = ['Wind', 'Water', 'Fire'] a.join() //=> 'Wind,Water,Fire' a.join("") //=> 'WindWaterFire'

Array.last() 最后()

Description: 返回数组的最后一个元素

Syntax: 语法: Array.last()

Returns: 返回: 任意

Source: 来源: 自定义 n8n 功能

Examples: 示例:

```javascript // arr = ['quick', 'brown', 'fox'] arr.last() //=> 'fox'

```

Array.length 长度

Description: 数组中的元素数量

Syntax: 语法:Array.长度

Returns: 返回: 编号

Source: 来源: JavaScript 函数

Examples: 示例:

javascript // names = ["Bob", "Bill", "Nat"]; names.length //=> 3

Array.map() 地图()

Description: 通过对原始数组的每个元素应用函数来创建一个新数组

Syntax: 语法: Array.map(函数(元素,索引?,数组?), thisValue?)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • function() (function) - 对每个数组元素执行的函数。在新数组中,该函数的输出将替代原来的元素。建议使用箭头函数表示法以节省空间。
  • element (any) - 当前元素的值
  • index (Number) - 可选 - 当前元素在数组中的位置(从 0 开始)
  • array (Array) - 可选 - 当前元素所在的数组。很少需要使用。
  • thisValue (any) - 可选 - 作为函数 this 值传递的值。很少需要使用。

Examples: 示例:

javascript // Double all numbers (using arrow function notation): // nums = [12, 33, 16] nums.map(num => num*2) //=> [24, 66, 32]

```javascript // Convert elements to uppercase (using arrow function notation): // words = ['hello', 'old', 'chap'] words.map(word => word.toUpperCase()) //=> ['HELLO', 'OLD', 'CHAP']]

// Or using traditional function notation: words.map(function(word){return word.toUpperCase()}) //=> ['HELLO', 'OLD', 'CHAP']] ```

Array.max() 最大()

Description: 返回数组中的最大数字。如果包含非数字元素则抛出错误。

Syntax: 语法: Array.max()

Returns: 返回: 编号

Source: 来源: 自定义 n8n 功能

Examples: 示例:

```javascript // arr = [1, 12, 5] arr.max() //=> 12

```

Array.mergeIntoObject()

Description: 将两个 Object 数组合并为一个 Object,方法是合并每个元素的键值对。如果数组长度不同,则保留较长数组中的元素。

Syntax: 语法: Array.mergeIntoObject(otherArray)

Returns: 返回: Object

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • otherArray (Array) - 要与基础数组合并的 Object 数组

Examples: 示例:

javascript // arr = [{ name: 'Nathan' }, { age: 42 }] arr.mergeIntoObject([{ city: 'Berlin' }]) //=> { name: 'Nathan', age: 42, city: 'Berlin' }

Array.min() 最小()

Description: 返回数组中的最小数字。如果包含非数字元素则抛出错误。

Syntax: 语法: Array.min()

Returns: 返回: 编号

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = [12, 1, 5] arr.min() //=> 1

Array.pluck() 拔()

Description: 返回一个数组,包含数组中每个 Object 的指定字段值。会忽略不是 Object 或没有匹配字段名的数组元素。

Syntax: 语法: Array.pluck(fieldName1?, fieldName2?, …)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • fieldName1 (String) - 可选 - 要获取值的第一个键名
  • fieldName2 (String) - 可选 - 要获取值的第二个键名

Examples: 示例:

javascript // arr = [{'name':'Nathan','age':42},{'name':'Jan','city':'Berlin'}] arr.pluck('name') //=> ["Nathan", "Jan"]

javascript // arr = [{'name':'Nathan','age':42},{'name':'Jan','city':'Berlin'}] arr.pluck('age') //=> [42]

Array.randomItem() 随机项()

Description: 从数组中随机返回一个元素

Syntax: 语法: Array.randomItem()

Returns: 返回: 任意

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = ['quick', 'brown', 'fox'] arr.randomItem() //=> 'brown' arr.randomItem() //=> 'quick'

Array.reduce() 减少()

Description: 通过对每个元素应用函数将数组缩减为单个值。该函数将当前元素与之前元素的缩减结果组合,产生新的结果。

Syntax: 语法: Array.reduce(函数(prevResult, currentElem, currentIndex?, array?), initResult)

Source: 来源: JavaScript 函数

Parameters: 参数:

  • function() (function) - 对每个数组元素执行的函数。接收累积结果和当前元素,返回新的累积结果。建议使用箭头函数表示法以节省空间。
  • prevResult (any) - 对前面元素应用函数后的累积结果。处理第一个元素时,该值被设置为 initResult(如果未指定则为数组的第一个元素)。
  • currentElem (any) - 当前正在处理的数组值
  • currentIndex (Number) - 可选 - 当前元素在数组中的位置(从 0 开始)
  • array (Array) - 可选 - 正在处理的数组。很少需要使用。
  • initResult (any) - 可选 - prevResult 的初始值,在对第一个数组元素调用函数时使用。未指定时,将设置为数组的第一个元素,且第一次函数调用将在第二个数组元素上执行而非第一个。

Examples: 示例:

javascript // Sum numbers (using arrow function notation): // nums = [12, 33, 16] nums.reduce((result, num) => (result+num), 0) //=> 61

```javascript // Join letters and uppercase (using arrow function notation): // chars = ['a', 'b', 'c'] chars.reduce((result, char) => (result+char.toUpperCase()), '') //=> 'ABC'

// Or using traditional function notation: chars.reduce(function(result, char){return result+char.toUpperCase()}, '') //=> 'ABC' ```

Array.removeDuplicates() 删除重复项()

Description: 移除数组中所有重复出现的元素

Syntax: 语法: Array.removeDuplicates(键?)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • keys (String) - 可选 - 用于 Object 数组。指定一个键名或逗号分隔的键名列表来限制检查范围。省略时检查所有键。

Examples: 示例:

javascript // arr = ['quick', 'brown', 'quick'] arr.removeDuplicates() //=> ['quick', 'brown']

Array.renameKeys() 重命名键()

Description: 更改数组中所有 Object 的匹配键名(字段名)。通过添加额外参数可以重命名多个键,即 from1, to1, from2, to2, ...。

Syntax: 语法: Array.renameKeys(从,到)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • from (String) - 要重命名的键名
  • to (String) - 新的键名

Examples: 示例:

javascript // arr = [{'name':'bob'},{'name':'meg'}] arr.renameKeys('name', 'x') //=> [{"x": "bob"},{"x": "meg"}]]

Array.reverse() 反向()

Description: 反转数组中元素的顺序

Syntax: 语法: Array.reverse()

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Examples: 示例:

javascript // arr = ['dog', 'bites', 'man'] arr.reverse() //=> ['man', 'bites', 'dog']

Array.slice() 切片()

Description: 返回数组的一部分,从 start 索引开始到 end 索引之前(不包含 end)。索引从 0 开始。

Syntax: 语法: Array.slice(开始,结束)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • start (Number) - 可选 - 开始位置。位置从 0 开始。负数表示从数组末尾倒数。
  • end (Number) - 可选 - 截取到的位置。该位置的元素不包含在内。负数表示从数组末尾选取。省略时将提取到数组末尾。

Examples: 示例:

javascript // arr = [1, 2, 3, 4, 5] arr.slice(2, 4) //=> [3, 4]

javascript // arr = [1, 2, 3, 4, 5] arr.slice(2) //=> [3, 4, 5]

javascript // arr = [1, 2, 3, 4, 5] arr.slice(-2) //=> [4, 5]

Array.smartJoin()

Description: 从 Object 数组创建单个 Object。数组中的每个 Object 为返回的 Object 提供一个字段。数组中的每个 Object 必须包含一个键名字段和一个值字段。

Syntax: 语法: Array.smartJoin(keyField, nameField)

Returns: 返回: 对象

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • keyField (String) - 每个 Object 中包含键名的字段
  • nameField (String) - 每个 Object 中包含值的字段

Examples: 示例:

javascript // arr => [{'field':'age','value':2},{'field':'city','value':'Berlin'}] arr.smartJoin('field','value') //=> {"age": 2, "city": "Berlin"}

Array.sort() 排序()

Description: 对数组中的元素重新排序。对字符串按字母顺序排序时,无需参数。对数字或 Object 排序时,请参见示例。

Syntax: 语法: Array.sort(compareFunction(a, b)?)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • compareFunction (function) - 可选 - 用于比较两个数组元素并返回一个数字来指示排序顺序的函数: 返回 < 0:a 排在 b 前面 返回 0:a 和 b 相等(保持原有顺序) 返回 > 0:b 排在 a 前面

如果未指定函数,则将所有值转换为字符串并比较它们的字符编码。 * a (any) - 函数中要比较的第一个元素 * b (any) - 函数中要比较的第二个元素

Examples: 示例:

javascript // No need for a param when sorting strings // arr = ['d', 'a', 'c', 'b'] arr.sort() //=> ['a', 'b', 'c', 'd']

```javascript // To sort numbers, you must use a function // arr = [4, 2, 1, 3] arr.sort((a, b) => (a - b)) //=> [1, 2, 3, 4]

// Or using traditional function notation: arr.sort(function(a, b){return a - b}) //=> [1, 2, 3, 4] ```

javascript // Sort in reverse alphabetical order // arr = ['d', 'a', 'c', 'b'] arr.sort((a, b) => b.localeCompare(a)) //=> ['d', 'c', 'b', 'a']

javascript // Sort array of objects by a property // arr = [{name:'Zak'}, {name:'Abe'}, {name:'Bob'}] arr.sort((a, b) => a.name.localeCompare(b.name)) //=> [{name:'Abe'}, {name:'Bob'}, {name:'Zak'}]

Array.sum() 求和()

Description: 返回数组中所有数字的总和。如果包含非数字元素则抛出错误。

Syntax: 语法: Array.sum()

Returns: 返回: 编号

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = [12, 1, 5] arr.sum() //=> 18

Array.toJsonString()

Description: 将数组转换为 JSON 字符串。与 JavaScript 的 JSON.stringify() 相同。

Syntax: 语法: Array.toJsonString()

Returns: 返回: 字符串

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // obj = ['quick', 'brown', 'fox'] obj.toJsonString() //=> '["quick","brown","fox"]'

Array.toSpliced()

Description: 在指定位置添加和/或删除数组元素。

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

Syntax: 语法: Array.toSpliced(开始,deleteCount,elem1,......,elemN)

Returns: 返回: 阵列

Source: 来源: JavaScript 函数

Parameters: 参数:

  • start (Number) - 添加或删除元素的索引(位置)。新元素将插入到该索引处的元素之前。负数表示从数组末尾倒数。
  • deleteCount (Number) - 可选 - 要删除的元素数量。省略时将删除从 start 索引开始的所有元素。
  • elem1 (any) - 可选 - 要添加的第一个新元素
  • elem2 (any) - 可选 - 要添加的第二个新元素
  • elemN (any) - 可选 - 要添加的第 N 个新元素

Examples: 示例:

javascript // Insert element at index 1 // months = ['Jan', 'Mar'] months.toSpliced(1, 0, "Feb") // ['Jan', 'Feb', 'Mar']

javascript // Delete 2 elements starting at index 1 // arr = ["don't", "make", "me", "do", "this"] arr.toSpliced(1, 2) // ["don't", "do", "this"]

javascript // Replace 2 elements starting at index 1 // arr = ["don't", "be", "evil"] arr.toSpliced(1, 2, 'eat', 'slugs') // ["don't", "eat", "slugs"]

Array.toString()

Description: 将数组转换为字符串,值之间用逗号分隔。如需使用其他分隔符,请使用 join()。

Syntax: 语法: Array.toString()

Returns: 返回: 字符串

Source: 来源: JavaScript 函数

Examples: 示例:

javascript // words = ['make', 'my', 'day'] words.toString() //=> 'make,my,day'

Array.union() 联合()

Description: 连接两个数组并去除重复元素

Syntax: 语法: Array.union(otherArray)

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Parameters: 参数:

  • otherArray (Array) - 要与基础数组合并的数组

Examples: 示例:

```javascript // arr = [1, 2] arr.union([2, 3]) //=> [1, 2, 3]

```

Array.unique() 唯一()

Description: 移除数组中的所有重复元素

Syntax: 语法: Array.unique()

Returns: 返回: 阵列

Source: 来源: 自定义 n8n 功能

Examples: 示例:

javascript // arr = ['quick', 'brown', 'quick'] arr.unique() //=> ['quick', 'brown']

相关资源

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