Array.append()#

설명: 배열의 끝에 새 요소를 추가합니다. push()와 비슷하지만, 수정된 배열을 반환합니다. 대신 스프레드 구문을 사용하는 것도 고려해보세요(예제 참고).

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

반환값: Array

소스: n8n 커스텀 기능

매개변수:

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

// 대신 스프레드 구문을 사용하는 것도 고려해보세요
[...arr, 1, 0]  //=> [9, 0, 2, 1, 0]

Array.average()#

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

구문: Array.average()

반환값: Number

소스: n8n 커스텀 기능

예제:

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

Array.chunk()#

설명: 배열을 지정한 길이만큼의 하위 배열로 이루어진 배열로 분할합니다

구문: Array.chunk(length)

반환값: Array

소스: n8n 커스텀 기능

매개변수:

• 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

소스: n8n 커스텀 기능

예제:

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

Array.concat()#

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

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

반환값: Array

소스: JavaScript 함수

매개변수:

• 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

소스: n8n 커스텀 기능

매개변수:

• 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) - 배열의 각 요소에 대해 실행할 함수입니다. true를 반환하면 해당 요소가 유지됩니다. 공간을 절약하려면 <a href=”https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions”>화살표 함수 표기법을 사용하는 것을 고려해보세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치(0부터 시작)
• array (Array) - 선택 사항 - 처리 중인 배열입니다. 거의 필요하지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값입니다. 거의 필요하지 않습니다.

예제:

// 18세 초과인 나이만 유지(화살표 함수 표기법 사용):
// ages = [12, 33, 16, 40]
ages.filter(age => (age > 18)) //=> [33, 40]

// 5자 미만인 이름만 유지(화살표 함수 표기법 사용):
// names = ['Nathan', 'Bob', 'Sebastian']
ages.filter(age => (age.length < 5)) //=> ["Bob"]

// 또는 전통적인 함수 표기법 사용:
ages.filter(function(age){return age.length < 5}) //=> ["Bob"]

// 홀수 인덱스에 있는 숫자만 유지
// 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) - 배열의 각 요소에 대해 실행할 함수입니다. true를 반환하는 즉시 해당 요소가 반환됩니다. 공간을 절약하려면 <a href=”https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions”>화살표 함수 표기법을 사용하는 것을 고려해보세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치(0부터 시작)
• array (Array) - 선택 사항 - 현재 요소가 속한 배열입니다. 거의 필요하지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값입니다. 거의 필요하지 않습니다.

예제:

// 18세를 초과하는 첫 번째 나이 찾기(화살표 함수 표기법 사용):
// ages = [12, 33, 16, 40]
ages.find(age => (age > 18)) //=> 33

// 5자 미만인 첫 번째 이름 찾기(화살표 함수 표기법 사용):
// names = ['Nathan', 'Bob', 'Sebastian']
ages.find(age => (age.length < 5)) //=> 'Bob'

// 또는 전통적인 함수 표기법 사용:
ages.find(function(age){return age.length < 5}) //=> 'Bob'

Array.first()#

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

구문: Array.first()

반환값: any

소스: n8n 커스텀 기능

예제:

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

Array.includes()#

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

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

반환값: Boolean

소스: JavaScript 함수

매개변수:

• 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 함수

매개변수:

• 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

소스: n8n 커스텀 기능

매개변수:

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

예제:

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

Array.isEmpty()#

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

구문: Array.isEmpty()

반환값: Boolean

소스: n8n 커스텀 기능

예제:

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

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

Array.isNotEmpty()#

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

구문: Array.isNotEmpty()

반환값: Boolean

소스: n8n 커스텀 기능

예제:

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

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

Array.join()#

설명: 각 요소 사이에 선택적으로 구분자를 넣어 배열의 모든 요소를 하나의 문자열로 결합합니다.

split()의 반대 동작입니다.

구문: Array.join(separator?)

반환값: String

소스: JavaScript 함수

매개변수:

• 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

소스: n8n 커스텀 기능

예제:

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

Array.length#

설명: 배열에 있는 요소의 개수

구문: Array.length

반환값: Number

소스: JavaScript 함수

예제:

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

Array.map()#

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

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

반환값: Array

소스: JavaScript 함수

매개변수:

• function() (function) - 배열의 각 요소에 대해 실행할 함수입니다. 새 배열에서는 이 함수의 출력 값이 해당 요소 자리를 대신합니다. 공간을 절약하려면 <a href=”https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions”>화살표 함수 표기법을 사용하는 것을 고려해보세요.
• element (any) - 현재 요소의 값
• index (Number) - 선택 사항 - 배열에서 현재 요소의 위치(0부터 시작)
• array (Array) - 선택 사항 - 현재 요소가 속한 배열입니다. 거의 필요하지 않습니다.
• thisValue (any) - 선택 사항 - 함수의 this 값으로 전달되는 값입니다. 거의 필요하지 않습니다.

예제:

// 모든 숫자를 2배로(화살표 함수 표기법 사용):
// nums = [12, 33, 16]
nums.map(num => num*2) //=> [24, 66, 32]

// 요소를 대문자로 변환(화살표 함수 표기법 사용):
// words = ['hello', 'old', 'chap']
words.map(word => word.toUpperCase()) //=> ['HELLO', 'OLD', 'CHAP']]

// 또는 전통적인 함수 표기법 사용:
words.map(function(word){return word.toUpperCase()}) //=> ['HELLO', 'OLD', 'CHAP']]

Array.max()#

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

구문: Array.max()

반환값: Number

소스: n8n 커스텀 기능

예제:

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

Array.min()#

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

구문: Array.min()

반환값: Number

소스: n8n 커스텀 기능

예제:

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

Array.pluck()#

설명: 배열에 있는 각 Object에서 지정한 필드(들)의 값을 담은 배열을 반환합니다. Object가 아니거나 지정한 필드 이름과 일치하는 키가 없는 배열 요소는 무시합니다.

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

반환값: Array

소스: n8n 커스텀 기능

매개변수:

• 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

소스: n8n 커스텀 기능

예제:

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

Array.reduce()#

설명: 각 요소에 함수를 적용하여 배열을 단일 값으로 축소합니다. 이 함수는 현재 요소와 이전 요소들을 축소한 결과를 결합하여 새로운 결과를 만듭니다.

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

소스: JavaScript 함수

매개변수:

• function() (function) - 배열의 각 요소에 대해 실행할 함수입니다. 누적 결과와 현재 요소를 받아 새로운 누적 결과를 반환합니다. 공간을 절약하려면 <a href=”https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions”>화살표 함수 표기법을 사용하는 것을 고려해보세요.
• prevResult (any) - 이전 요소들에 함수를 적용하여 누적된 결과입니다. 첫 번째 요소를 처리할 때는 initResult(지정하지 않은 경우 배열의 첫 번째 요소)로 설정됩니다.
• currentElem (any) - 현재 처리 중인 배열의 값
• currentIndex (Number) - 선택 사항 - 배열에서 현재 요소의 위치(0부터 시작)
• array (Array) - 선택 사항 - 처리 중인 배열입니다. 거의 필요하지 않습니다.
• initResult (any) - 선택 사항 - 배열의 첫 번째 요소에 함수를 호출할 때 사용되는 prevResult의 초기값입니다. 지정하지 않으면 배열의 첫 번째 요소로 설정되며, 첫 번째 함수 호출은 첫 번째 요소가 아닌 두 번째 배열 요소에 대해 실행됩니다.

예제:

// 숫자 합산(화살표 함수 표기법 사용):
// nums = [12, 33, 16]
nums.reduce((result, num) => (result+num), 0) //=> 61

// 문자를 이어붙이고 대문자로 변환(화살표 함수 표기법 사용):
// chars = ['a', 'b', 'c']
chars.reduce((result, char) => (result+char.toUpperCase()), '') //=> 'ABC'

// 또는 전통적인 함수 표기법 사용:
chars.reduce(function(result, char){return result+char.toUpperCase()}, '') //=> 'ABC'

Array.removeDuplicates()#

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

구문: Array.removeDuplicates(keys?)

반환값: Array

소스: n8n 커스텀 기능

매개변수:

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

예제:

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

Array.renameKeys()#

설명: 배열에 있는 모든 Object에서 일치하는 키(필드 이름)를 변경합니다. from1, to1, from2, to2, ...와 같이 인수를 추가하여 둘 이상의 키를 변경할 수 있습니다.

구문: Array.renameKeys(from, to)

반환값: Array

소스: n8n 커스텀 기능

매개변수:

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

예제:

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

Array.reverse()#

설명: 배열 요소의 순서를 뒤집습니다

구문: Array.reverse()

반환값: Array

소스: JavaScript 함수

예제:

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

Array.slice()#

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

구문: Array.slice(start, end)

반환값: Array

소스: JavaScript 함수

매개변수:

• 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

소스: n8n 커스텀 기능

매개변수:

• 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 함수

매개변수:

• compareFunction (function) - 선택 사항 - 두 배열 요소를 비교하여 어느 것이 먼저 오는지 나타내는 숫자를 반환하는 함수입니다: 0보다 작은 값 반환: a가 b보다 먼저 옵니다 0 반환: a와 b가 같습니다(순서를 그대로 유지) 0보다 큰 값 반환: b가 a보다 먼저 옵니다

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

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

예제:

// 문자열을 정렬할 때는 매개변수가 필요 없습니다
// arr = ['d', 'a', 'c', 'b']
arr.sort() //=> ['a', 'b', 'c', 'd']

// 숫자를 정렬하려면 함수를 사용해야 합니다
// arr = [4, 2, 1, 3]
arr.sort((a, b) => (a - b)) //=> [1, 2, 3, 4]

// 또는 전통적인 함수 표기법 사용:
arr.sort(function(a, b){return a - b}) //=> [1, 2, 3, 4]

// 알파벳 역순으로 정렬
// arr = ['d', 'a', 'c', 'b']
arr.sort((a, b) => b.localeCompare(a)) //=> ['d', 'c', 'b', 'a']

// 속성을 기준으로 Object 배열 정렬
// 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

소스: n8n 커스텀 기능

예제:

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

Array.toJsonString()#

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

구문: Array.toJsonString()

반환값: String

소스: n8n 커스텀 기능

예제:

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

Array.toSpliced()#

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

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

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

반환값: Array

소스: JavaScript 함수

매개변수:

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

예제:

// 인덱스 1에 요소 삽입
// months = ['Jan', 'Mar']
months.toSpliced(1, 0, "Feb") // ['Jan', 'Feb', 'Mar']

// 인덱스 1부터 시작하여 요소 2개 삭제
// arr = ["don't", "make", "me", "do", "this"]
arr.toSpliced(1, 2) // ["don't", "do", "this"]

// 인덱스 1부터 시작하여 요소 2개 교체
// arr = ["don't", "be", "evil"]
arr.toSpliced(1, 2, 'eat', 'slugs') // ["don't", "eat", "slugs"]

Array.toString()#

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

구문: Array.toString()

반환값: String

소스: JavaScript 함수

예제:

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

Array.union()#

설명: 두 배열을 연결한 다음 중복 요소를 제거합니다

구문: Array.union(otherArray)

반환값: Array

소스: n8n 커스텀 기능

매개변수:

• otherArray (Array) - 기본 배열과 합칠 배열

예제:

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

Array.unique()#

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

구문: Array.unique()

반환값: Array

소스: n8n 커스텀 기능

예제:

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