Array.append()#

설명: 배열의 끝에 새 요소를 추가합니다. push()와 유사하지만 수정된 배열을 반환합니다. 대신 스프레드 문법 사용을 고려하세요 (예시 참고).

구문: Array.append(elem1, elem2?, ..., elemN?)

반환값: Array

출처: Custom n8n functionality

매개변수:

• elem1 (any) - 추가할 첫 번째 요소
• elem2 (any) - 선택 사항 - 추가할 두 번째 요소
• elemN (any) - 선택 사항 - 추가할 N번째 요소

예시:

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

// 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()#

설명: 배열에 있는 숫자들의 평균을 반환합니다. 숫자가 아닌 값이 있으면 오류가 발생합니다.

구문: Array.average()

반환값: Number

출처: Custom n8n functionality

예시:

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

Array.chunk()#

설명: 배열을 지정된 길이를 가진 하위 배열들의 배열로 분할합니다

구문: Array.chunk(length)

반환값: Array

출처: Custom n8n functionality

매개변수:

• length (Number) - 각 청크의 요소 수

예시:

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

Array.compact()#

설명: 배열에서 빈 값을 모두 제거합니다. null, "", undefined는 빈 값으로 간주됩니다.

구문: Array.compact()

반환값: Array

출처: Custom n8n functionality

예시:

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

Array.concat()#

설명: 기본 배열의 끝에 하나 이상의 배열을 연결합니다

구문: Array.concat(array2, array3?, ... arrayN?)

반환값: Array

출처: JavaScript function

매개변수:

• array2 (Array) - 기본 배열의 끝에 연결할 첫 번째 배열
• array3 (Array) - 선택 사항 - 기본 배열의 끝에 연결할 두 번째 배열
• arrayN (Array) - 선택 사항 - 기본 배열의 끝에 연결할 N번째 배열

예시:

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

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

Array.difference()#

설명: 두 배열을 비교합니다. 기본 배열에 있지만 otherArray에는 없는 모든 요소를 반환합니다.

구문: Array.difference(otherArray)

반환값: Array

출처: Custom n8n functionality

매개변수:

• otherArray (Array) - 기본 배열과 비교할 배열

예시:

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

Array.filter()#

설명: 조건을 만족하는 요소만 포함하는 배열을 반환합니다. 조건은 true 또는 false를 반환하는 함수입니다.

구문: Array.filter(function(element, index?, array?), thisValue?)

반환값: Array

출처: JavaScript function

매개변수:

• function() (function) - 각 배열 요소에 대해 실행할 함수. true를 반환하면 해당 요소가 유지됩니다. 코드를 줄이려면 화살표 함수 표기법을 사용하세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치 (0부터 시작)
• array (Array) - 선택 사항 - 처리 중인 배열. 거의 사용되지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값. 거의 사용되지 않습니다.

예시:

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

// 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"]

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

Array.find()#

설명: 제공된 조건을 만족하는 배열의 첫 번째 요소를 반환합니다. 조건은 true 또는 false를 반환하는 함수입니다. 일치하는 항목이 없으면 undefined를 반환합니다.

일치하는 모든 요소가 필요한 경우 filter()를 사용하세요.

구문: Array.find(function(element, index?, array?), thisValue?)

반환값: any

출처: JavaScript function

매개변수:

• function() (function) - 각 배열 요소에 대해 실행할 함수. true를 반환하는 즉시 해당 요소가 반환됩니다. 코드를 줄이려면 화살표 함수 표기법을 사용하세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치 (0부터 시작)
• array (Array) - 선택 사항 - 현재 요소의 배열. 거의 사용되지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값. 거의 사용되지 않습니다.

예시:

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

// 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()#

설명: 배열의 첫 번째 요소를 반환합니다

구문: Array.first()

반환값: any

출처: Custom n8n functionality

예시:

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

Array.includes()#

설명: 배열에 지정된 요소가 포함되어 있으면 true를 반환합니다

구문: Array.includes(element, start?)

반환값: Boolean

출처: JavaScript function

매개변수:

• element (any) - 배열에서 검색할 값
• start (Number) - 선택 사항 - 검색을 시작할 인덱스

예시:

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

Array.indexOf()#

설명: 배열에서 첫 번째로 일치하는 요소의 위치를 반환하거나, 요소를 찾지 못하면 -1을 반환합니다. 위치는 0부터 시작합니다.

구문: Array.indexOf(element, start?)

반환값: Number

출처: JavaScript function

매개변수:

• element (any) - 찾을 값
• start (Number) - 선택 사항 - 검색을 시작할 인덱스

예시:

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

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

Array.intersection()#

설명: 두 배열을 비교합니다. 기본 배열과 다른 배열 모두에 존재하는 모든 요소를 반환합니다.

구문: Array.intersection(otherArray)

반환값: Array

출처: Custom n8n functionality

매개변수:

• otherArray (Array) - 기본 배열과 비교할 배열

예시:

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

Array.isEmpty()#

설명: 배열에 요소가 없거나 null이면 true를 반환합니다

구문: Array.isEmpty()

반환값: Boolean

출처: Custom n8n functionality

예시:

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

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

Array.isNotEmpty()#

설명: 배열에 하나 이상의 요소가 있으면 true를 반환합니다

구문: Array.isNotEmpty()

반환값: Boolean

출처: Custom n8n functionality

예시:

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

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

Array.join()#

설명: 배열의 모든 요소를 단일 문자열로 병합하며, 각 요소 사이에 선택적 구분자를 삽입합니다.

split()의 반대입니다.

구문: Array.join(separator?)

반환값: String

출처: JavaScript function

매개변수:

• separator (String) - 선택 사항 - 각 요소 사이에 삽입할 문자(들)

예시:

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

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

Array.last()#

설명: 배열의 마지막 요소를 반환합니다

구문: Array.last()

반환값: any

출처: Custom n8n functionality

예시:

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

Array.length#

설명: 배열의 요소 수

구문: Array.length

반환값: Number

출처: JavaScript function

예시:

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

Array.map()#

설명: 원본 배열의 각 요소에 함수를 적용하여 새 배열을 만듭니다

구문: Array.map(function(element, index?, array?), thisValue?)

반환값: Array

출처: JavaScript function

매개변수:

• function() (function) - 각 배열 요소에 대해 실행할 함수. 새 배열에서 이 함수의 출력이 요소 자리를 대체합니다. 코드를 줄이려면 화살표 함수 표기법을 사용하세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치 (0부터 시작)
• array (Array) - 선택 사항 - 현재 요소의 배열. 거의 사용되지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값. 거의 사용되지 않습니다.

예시:

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

// 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()#

설명: 배열에서 가장 큰 숫자를 반환합니다. 숫자가 아닌 값이 있으면 오류가 발생합니다.

구문: Array.max()

반환값: Number

출처: Custom n8n functionality

예시:

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

Array.min()#

설명: 배열에서 가장 작은 숫자를 반환합니다. 숫자가 아닌 값이 있으면 오류가 발생합니다.

구문: Array.min()

반환값: Number

출처: Custom n8n functionality

예시:

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

Array.pluck()#

설명: 배열의 각 Object에서 지정된 필드의 값을 포함하는 배열을 반환합니다. Object가 아니거나 제공된 필드 이름과 일치하는 키가 없는 배열 요소는 무시합니다.

구문: Array.pluck(fieldName1?, fieldName2?, …)

반환값: Array

출처: Custom n8n functionality

매개변수:

• fieldName1 (String) - 선택 사항 - 값을 가져올 첫 번째 키
• fieldName2 (String) - 선택 사항 - 값을 가져올 두 번째 키

예시:

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

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

Array.randomItem()#

설명: 배열에서 무작위로 선택된 요소를 반환합니다

구문: Array.randomItem()

반환값: any

출처: Custom n8n functionality

예시:

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

Array.reduce()#

설명: 각 요소에 함수를 적용하여 배열을 단일 값으로 줄입니다. 함수는 현재 요소와 이전 요소들을 줄인 결과를 결합하여 새 결과를 생성합니다.

구문: Array.reduce(function(prevResult, currentElem, currentIndex?, array?), initResult)

출처: JavaScript function

매개변수:

• function() (function) - 각 배열 요소에 대해 실행할 함수. 누적된 결과와 현재 요소를 받아 새로운 누적 결과를 반환합니다. 코드를 줄이려면 화살표 함수 표기법을 사용하세요.
• prevResult (any) - 이전 요소들에 함수를 적용하여 누적된 결과. 첫 번째 요소를 처리할 때는 initResult로 설정됩니다 (지정되지 않은 경우 첫 번째 배열 요소).
• currentElem (any) - 현재 처리 중인 배열의 값
• currentIndex (Number) - 선택 사항 - 배열에서 현재 요소의 위치 (0부터 시작)
• array (Array) - 선택 사항 - 처리 중인 배열. 거의 사용되지 않습니다.
• initResult (any) - 선택 사항 - 첫 번째 배열 요소에 함수를 호출할 때 사용되는 prevResult의 초기값. 지정하지 않으면 첫 번째 배열 요소로 설정되고, 첫 번째 함수 호출은 첫 번째가 아닌 두 번째 배열 요소에 대해 이루어집니다.

예시:

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

// 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()#

설명: 배열에서 반복되는 요소를 제거합니다

구문: Array.removeDuplicates(keys?)

반환값: Array

출처: Custom n8n functionality

매개변수:

• keys (String) - 선택 사항 - Object 배열에서 사용. 검사를 제한할 키 또는 쉼표로 구분된 키 목록. 생략하면 모든 키가 검사됩니다.

예시:

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

Array.renameKeys()#

설명: 배열의 모든 Object에서 일치하는 키(필드 이름)를 변경합니다. 여러 키를 이름 변경하려면 인수를 추가하세요. 예: from1, to1, from2, to2, ....

구문: Array.renameKeys(from, to)

반환값: Array

출처: Custom n8n functionality

매개변수:

• from (String) - 이름을 변경할 키
• to (String) - 새 키 이름

예시:

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

Array.reverse()#

설명: 배열의 요소 순서를 역순으로 변경합니다

구문: Array.reverse()

반환값: Array

출처: JavaScript function

예시:

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

Array.slice()#

설명: start 인덱스부터 end 인덱스까지(포함하지 않음) 배열의 일부를 반환합니다. 인덱스는 0부터 시작합니다.

구문: Array.slice(start, end)

반환값: Array

출처: JavaScript function

매개변수:

• start (Number) - 선택 사항 - 시작할 위치. 위치는 0부터 시작합니다. 음수는 배열 끝에서부터 거슬러 올라갑니다.
• end (Number) - 선택 사항 - 선택할 끝 위치. end 위치의 요소는 포함되지 않습니다. 음수는 배열 끝에서부터 선택합니다. 생략하면 배열 끝까지 추출합니다.

예시:

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

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

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

Array.smartJoin()#

설명: Object 배열에서 단일 Object를 만듭니다. 배열의 각 Object는 반환된 Object에 대한 하나의 필드를 제공합니다. 배열의 각 Object는 키 이름이 있는 필드와 값이 있는 필드를 포함해야 합니다.

구문: Array.smartJoin(keyField, nameField)

반환값: Object

출처: Custom n8n functionality

매개변수:

• keyField (String) - 각 Object에서 키 이름을 포함하는 필드
• nameField (String) - 각 Object에서 값을 포함하는 필드

예시:

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

Array.sort()#

설명: 배열의 요소를 재정렬합니다. 문자열을 알파벳순으로 정렬할 때는 매개변수가 필요 없습니다. 숫자나 Object를 정렬하려면 예시를 참고하세요.

구문: Array.sort(compareFunction(a, b)?)

반환값: Array

출처: JavaScript function

매개변수:

• compareFunction (function) - 선택 사항 - 두 배열 요소를 비교하여 어느 것이 먼저 오는지를 나타내는 숫자를 반환하는 함수: Return < 0: a가 b 앞에 옵니다 Return 0: a와 b는 같습니다 (순서 변경 없음) Return > 0: b가 a 앞에 옵니다

함수를 지정하지 않으면 모든 값을 문자열로 변환하고 문자 코드를 비교합니다.

• a (any) - 함수에서 비교할 첫 번째 요소
• b (any) - 함수에서 비교할 두 번째 요소

예시:

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

// 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]

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

// 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()#

설명: 배열의 모든 숫자의 합계를 반환합니다. 숫자가 아닌 값이 있으면 오류가 발생합니다.

구문: Array.sum()

반환값: Number

출처: Custom n8n functionality

예시:

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

Array.toJsonString()#

설명: 배열을 JSON 문자열로 변환합니다. JavaScript의 JSON.stringify()와 동일합니다.

구문: Array.toJsonString()

반환값: String

출처: Custom n8n functionality

예시:

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

Array.toSpliced()#

설명: 지정된 위치에서 배열 요소를 추가 및/또는 제거합니다.

slice() 및 append()도 참고하세요.

구문: Array.toSpliced(start, deleteCount, elem1, ....., elemN)

반환값: Array

출처: JavaScript function

매개변수:

• start (Number) - 요소를 추가하거나 제거할 인덱스(위치). 새 요소는 이 인덱스의 요소 앞에 삽입됩니다. 음수 인덱스는 배열 끝에서부터 거슬러 올라갑니다.
• deleteCount (Number) - 선택 사항 - 제거할 요소 수. 생략하면 start 인덱스부터 모든 요소를 제거합니다.
• elem1 (any) - 선택 사항 - 추가될 첫 번째 새 요소
• elem2 (any) - 선택 사항 - 추가될 두 번째 새 요소
• elemN (any) - 선택 사항 - 추가될 N번째 새 요소

예시:

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

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

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

Array.toString()#

설명: 배열을 쉼표로 구분된 값들의 문자열로 변환합니다. 다른 구분자를 사용하려면 join()을 사용하세요.

구문: Array.toString()

반환값: String

출처: JavaScript function

예시:

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

Array.union()#

설명: 두 배열을 연결한 다음 중복 항목을 제거합니다

구문: Array.union(otherArray)

반환값: Array

출처: Custom n8n functionality

매개변수:

• otherArray (Array) - 기본 배열과 합집합을 만들 배열

예시:

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

Array.unique()#

설명: 배열에서 중복 요소를 제거합니다

구문: Array.unique()

반환값: Array

출처: Custom n8n functionality

예시:

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