InfoGrab Docs

표현식 레퍼런스

요약

아래는 자주 사용되는 표현식 목록입니다. 아래 표를 탐색하여 데이터 타입별 메서드를 찾으세요. Array.append(elem1, elem2?, ..., elemN?) 배열의 끝에 새 요소를 추가합니다. 배열에 있는 숫자의 평균값을 반환합니다.

아래는 자주 사용되는 표현식 목록입니다. 더 상세한 전체 목록은 아래 표를 참조하세요.

카테고리 표현식 설명
현재 입력 아이템 데이터 접근 $json 현재 아이템의 JSON 데이터
$json.fieldName 현재 아이템의 필드
$binary 현재 아이템의 바이너리 데이터
이전 노드 데이터 접근 $("NodeName").first() 노드의 첫 번째 아이템
$("NodeName").item 노드의 연결된 아이템. 자세한 내용은 아이템 연결을 참조하세요.
$("NodeName").all() 노드의 모든 아이템
$("NodeName").last() 노드의 마지막 아이템
날짜/시간 $now 현재 날짜 및 시간
$today 오늘 날짜
$now.toFormat("yyyy-MM-dd") 현재 날짜를 문자열로 포맷
조건문 $if(condition, "true", "false") 조건이 참 또는 거짓일 때 값을 반환하는 헬퍼 함수
condition ? true : false 삼항 연산자: 조건이 참이면 하나의 값을, 거짓이면 다른 값을 반환
$ifEmpty(value, defaultValue) 두 개의 파라미터를 받아 첫 번째 파라미터가 비어 있는지 확인한 후, 파라미터가 비어 있지 않으면 해당 파라미터를, 비어 있으면 두 번째 파라미터를 반환하는 헬퍼 함수. 첫 번째 파라미터는 undefined, null, 빈 문자열 '', value.lengthfalse를 반환하는 배열, 또는 Object.keys(value).lengthfalse를 반환하는 객체인 경우 비어 있다고 간주함
문자열 메서드 text.toUpperCase() 대문자로 변환
text.toLowerCase() 소문자로 변환
text.includes("foo") 텍스트에 검색어가 포함되어 있는지 확인
text.extractEmail() 텍스트에서 이메일 추출
배열 메서드 array.length 배열 길이 가져오기
array.join(", ") 쉼표를 구분자로 배열 요소 연결
array.filter(x => x <= 20) 필터 조건에 따라 배열 아이템 필터링
array.map(x => x.id) 배열의 아이템 변환

아래 표를 탐색하여 데이터 타입별 메서드를 찾으세요. 메서드 이름을 클릭하면 상세 문서를 확인할 수 있습니다.

Array#

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

  • Array.first()

    배열의 첫 번째 요소를 반환합니다.

  • Array.includes(element, start?)

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

  • Array.indexOf(element, start?)

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

  • Array.intersection(otherArray)

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

  • Array.isEmpty()

    배열에 요소가 없거나 null인 경우 true를 반환합니다.

  • Array.isNotEmpty()

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

  • Array.join(separator?)

    배열의 모든 요소를 하나의 문자열로 합칩니다. 각 요소 사이에 선택적 구분자를 사용할 수 있습니다.

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

  • Array.last()

    배열의 마지막 요소를 반환합니다.

  • Array.length

    배열의 요소 수

  • Array.map(function(element, index?, array?), thisValue?)

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

  • Array.max()

    배열에서 가장 큰 숫자를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.min()

    배열에서 가장 작은 숫자를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.pluck(fieldName1?, fieldName2?, …)

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

  • Array.randomItem()

    배열에서 무작위로 선택한 요소를 반환합니다.

  • Array.reduce(function(prevResult, currentElem, currentIndex?, array?), initResult)

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

  • Array.removeDuplicates(keys?)

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

  • Array.renameKeys(from, to)

    배열 내 Object의 일치하는 키(필드 이름)를 모두 변경합니다. 추가 인수를 사용하여 여러 키를 이름 변경할 수 있습니다. 예: from1, to1, from2, to2, ....

  • Array.reverse()

    배열의 요소 순서를 뒤집습니다.

  • Array.slice(start, end)

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

  • Array.smartJoin(keyField, nameField)

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

  • Array.sort(compareFunction(a, b)?)

    배열의 요소 순서를 재정렬합니다. 알파벳순으로 문자열을 정렬할 때는 파라미터가 필요 없습니다. 숫자나 Object를 정렬하려면 예시를 참조하세요.

  • Array.sum()

    배열의 모든 숫자의 합계를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.toJsonString()

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

  • Array.toSpliced(start, deleteCount, elem1, ....., elemN)

    지정된 위치에서 배열 요소를 추가하거나 제거합니다.

slice()append()도 참조하세요.

  • Array.toString()

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

  • Array.union(otherArray)

    두 배열을 연결한 후 중복을 제거합니다.

  • Array.unique()

    배열에서 중복 요소를 제거합니다.

BinaryFile#

  • binaryFile.directory

    파일이 저장된 디렉토리 경로. 다른 디렉토리에 같은 이름의 파일을 구별할 때 유용합니다. n8n이 데이터베이스에 파일을 저장하도록 구성된 경우에는 설정되지 않습니다.

  • binaryFile.fileExtension

    파일 이름에 붙은 접미사 (예: txt)

  • binaryFile.fileName

    확장자를 포함한 파일 이름

  • binaryFile.fileSize

    파일 크기를 나타내는 문자열

  • binaryFile.fileType

    파일 유형을 나타내는 문자열 (예: image). MIME 타입의 첫 번째 부분에 해당합니다.

  • binaryFile.id

    파일의 고유 ID. 파일이 디스크나 S3 같은 스토리지 서비스에 저장될 때 파일을 식별하는 데 사용됩니다.

  • binaryFile.mimeType

    파일 내용의 형식을 나타내는 문자열 (예: image/jpeg)

Boolean#

  • Boolean.isEmpty()

    모든 boolean에 대해 false를 반환합니다. null에 대해서는 true를 반환합니다.

  • Boolean.toNumber()

    true를 1로, false를 0으로 변환합니다.

  • Boolean.toString()

    true를 문자열 'true'로, false를 문자열 'false'로 변환합니다.

CustomData#

Date#

  • Date.toDateTime()

    JavaScript Date를 Luxon DateTime으로 변환합니다. DateTime은 동일한 정보를 포함하지만 조작하기 더 쉽습니다.

DateTime#

  • DateTime.day

    월의 날짜 (1-31)

  • DateTime.diffTo(otherDateTime, unit)

    지정된 단위로 두 DateTime 간의 차이를 반환합니다.

  • DateTime.diffToNow(unit)

    지정된 단위로 현재 시점과 DateTime 간의 차이를 반환합니다. 텍스트 표현을 원하면 toRelative()를 사용하세요.

  • DateTime.endOf(unit, opts)

    DateTime을 해당 단위의 끝으로 올림합니다. 예: 월말

  • DateTime.equals(other)

    두 DateTime이 정확히 동일한 순간을 나타내고 같은 타임존에 있으면 true를 반환합니다. 덜 엄격한 비교를 위해서는 hasSame()을 사용하세요.

  • DateTime.extract(unit?)

    날짜나 시간의 일부(예: 월)를 숫자로 추출합니다. 텍스트 이름을 추출하려면 format()을 참조하세요.

  • DateTime.format(fmt)

    지정된 형식을 사용하여 DateTime을 문자열로 변환합니다. 포맷 가이드. 일반 형식의 경우 toLocaleString()이 더 간편할 수 있습니다.

  • DateTime.hasSame(otherDateTime, unit)

    두 DateTime이 지정된 단위까지 동일하면 true를 반환합니다. 타임존은 무시되고 로컬 시간만 비교되므로, 필요한 경우 먼저 toUTC()를 사용하세요.

  • DateTime.hour

    하루의 시간 (0-23)

  • DateTime.isBetween(date1, date2)

    DateTime이 지정된 두 시점 사이에 있으면 true를 반환합니다.

  • DateTime.isInDST

    DateTime이 일광 절약 시간제 적용 중인지 여부

  • DateTime.locale

    DateTime의 로케일 (예: 'en-GB'). 로케일은 DateTime을 포맷할 때 사용됩니다.

  • DateTime.millisecond

    초의 밀리초 (0-999)

  • DateTime.minus(n, unit?)

    DateTime에서 지정된 기간을 뺍니다.

  • DateTime.minute

    시간의 분 (0-59)

  • DateTime.month

    월 (1-12)

  • DateTime.monthLong

    텍스트로 된 긴 월 이름 (예: 'October'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.monthShort

    텍스트로 된 축약된 월 이름 (예: 'Oct'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.plus(n, unit?)

    DateTime에 지정된 기간을 더합니다.

  • DateTime.quarter

    연도의 분기 (1-4)

  • DateTime.second

    분의 초 (0-59)

  • DateTime.set(values)

    DateTime의 지정된 단위에 새 값을 할당합니다. DateTime을 반올림하려면 startOf()endOf()도 참조하세요.

  • DateTime.setLocale(locale)

    DateTime의 언어 및 포맷을 결정하는 로케일을 설정합니다. format()이나 toLocaleString()으로 DateTime의 텍스트 표현을 생성할 때 유용합니다.

  • DateTime.setZone(zone, opts)

    DateTime을 지정된 타임존으로 변환합니다. 옵션에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. toLocal()toUTC()도 참조하세요.

  • DateTime.startOf(unit, opts)

    DateTime을 해당 단위의 시작으로 내림합니다. 예: 월의 시작

  • DateTime.toISO(opts)

    DateTime의 ISO 8601 규격 문자열 표현을 반환합니다.

  • DateTime.toLocal()

    DateTime을 워크플로의 로컬 타임존으로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. 워크플로의 타임존은 워크플로 설정에서 변경할 수 있습니다.

  • DateTime.toLocaleString(formatOpts)

    DateTime을 나타내는 현지화된 문자열을 반환합니다. 즉, 해당 로케일에 해당하는 언어와 형식으로 표시됩니다. 지정된 로케일이 없으면 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.toMillis()

    밀리초 단위의 Unix 타임스탬프를 반환합니다 (1970년 1월 1일 이후 경과한 수).

  • DateTime.toRelative(options)

    현재 시간을 기준으로 상대적인 텍스트 표현을 반환합니다 (예: 'in two days'). 기본적으로 내림합니다.

  • DateTime.toSeconds()

    초 단위의 Unix 타임스탬프를 반환합니다 (1970년 1월 1일 이후 경과한 수).

  • DateTime.toString()

    DateTime의 문자열 표현을 반환합니다. toISO()와 유사합니다. 더 많은 포맷 옵션은 format()이나 toLocaleString()을 참조하세요.

  • DateTime.toUTC(offset, opts)

    DateTime을 UTC 타임존으로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. 다른 타임존으로 변환하려면 setZone()을 사용하세요.

  • DateTime.weekday

    요일. 1은 월요일, 7은 일요일입니다.

  • DateTime.weekdayLong

    텍스트로 된 긴 요일 이름 (예: 'Wednesday'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.weekdayShort

    텍스트로 된 축약된 요일 이름 (예: 'Wed'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.weekNumber

    연도의 주 번호 (1-52 정도)

  • DateTime.year

    연도

  • DateTime.zone

    DateTime과 연결된 타임존

ExecData#

  • $exec.customData

    커스텀 실행 데이터를 설정하고 가져옵니다 (예: 실행 필터링용). 'Execution Data' 노드로도 가능합니다. 자세히 보기

  • $exec.id

    현재 워크플로 실행의 ID

  • $exec.mode

    3가지 값 중 하나가 될 수 있습니다: test (n8n에서 버튼 클릭으로 실행이 트리거됨을 의미), production (자동으로 실행이 트리거됨을 의미). 워크플로 테스트 실행 시에는 evaluation이 사용됩니다.

  • $exec.resumeFormUrl

    'Wait' 노드에서 생성된 폼에 접근하기 위한 URL

  • $exec.resumeUrl

    'Wait' 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL

HTTPResponse#

  • $response.body

    마지막 HTTP 호출의 응답 객체 본문. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.headers

    마지막 HTTP 호출에서 반환된 헤더. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.statusCode

    마지막 HTTP 호출에서 반환된 HTTP 상태 코드. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.statusMessage

    요청 상태에 관한 선택적 메시지. 'HTTP Request' 노드에서만 사용 가능합니다.

Item#

NodeInputData#

NodeOutputData#

Number#

  • Number.abs()

    숫자의 절댓값을 반환합니다. 즉, 마이너스 부호를 제거합니다.

  • Number.ceil()

    숫자를 다음 정수로 올림합니다.

  • Number.floor()

    숫자를 가장 가까운 정수로 내림합니다.

  • Number.format(locale?, options?)

    숫자를 나타내는 포맷된 문자열을 반환합니다. 특정 언어나 통화 형식에 유용합니다. Intl.NumberFormat()과 동일합니다.

  • Number.isEmpty()

    모든 숫자에 대해 false를 반환합니다. null에 대해서는 true를 반환합니다.

  • Number.isEven()

    숫자가 짝수이면 true를 반환합니다. 정수가 아닌 경우 오류가 발생합니다.

  • Number.isInteger()

    숫자가 정수이면 true를 반환합니다.

  • Number.isOdd()

    숫자가 홀수이면 true를 반환합니다. 정수가 아닌 경우 오류가 발생합니다.

  • Number.round(decimalPlaces?)

    숫자를 가장 가까운 정수(또는 지정된 소수 자릿수)로 반올림합니다.

  • Number.toBoolean()

    숫자를 boolean 값으로 변환합니다. 0false가 되고, 나머지는 모두 true가 됩니다.

  • Number.toDateTime(format?)

    숫자형 타임스탬프를 DateTime으로 변환합니다. 밀리초가 아닌 경우 타임스탬프 형식을 지정해야 합니다. n8n의 타임존(또는 워크플로 설정의 타임존)을 사용합니다.

  • Number.toLocaleString(locales?, options?)

    숫자를 나타내는 현지화된 문자열을 반환합니다. 즉, 해당 로케일에 해당하는 언어와 형식으로 표시됩니다. 지정된 로케일이 없으면 시스템 로케일이 기본값으로 사용됩니다.

  • Number.toString(radix?)

    숫자를 간단한 텍스트 표현으로 변환합니다. 더 많은 포맷 옵션은 toLocaleString()을 참조하세요.

Object#

  • Object.compact()

    빈 값(null 또는 "")을 가진 모든 필드를 제거합니다.

  • Object.hasField(name)

    name이라는 필드가 있으면 true를 반환합니다. 최상위 키만 확인합니다. 비교는 대소문자를 구분합니다.

  • Object.isEmpty()

    Object에 키(필드)가 설정되어 있지 않거나 null인 경우 true를 반환합니다.

  • Object.isNotEmpty()

    Object에 하나 이상의 키(필드)가 설정되어 있으면 true를 반환합니다.

  • Object.keepFieldsContaining(value)

    값이 지정된 value와 부분적으로도 일치하지 않는 필드를 제거합니다. 비교는 대소문자를 구분합니다. 문자열이 아닌 필드는 항상 제거됩니다.

  • Object.keys()

    객체에 포함된 모든 필드 이름(키)의 배열을 반환합니다. JavaScript의 Object.keys(obj)와 동일합니다.

  • Object.merge(otherObject)

    두 Object를 하나로 병합합니다. 두 Object에 모두 키(필드 이름)가 있는 경우, 첫 번째(기본) Object의 값이 사용됩니다.

  • Object.removeField(key)

    Object에서 필드를 제거합니다. JavaScript의 delete와 동일합니다.

  • Object.removeFieldsContaining(value)

    값이 지정된 value와 부분적으로 일치하는 키(필드)를 제거합니다. 비교는 대소문자를 구분합니다. 문자열이 아닌 필드는 항상 유지됩니다.

  • Object.toJsonString()

    Object를 JSON 문자열로 변환합니다. JavaScript의 JSON.stringify()와 유사합니다.

  • Object.urlEncode()

    Object의 키와 값으로 URL 파라미터 문자열을 생성합니다. 최상위 키만 지원됩니다.

  • Object.values()

    Object에 포함된 모든 필드의 값 배열을 반환합니다. JavaScript의 Object.values(obj)와 동일합니다.

PrevNodeData#

  • name

    현재 입력이 들어온 노드의 이름.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

  • outputIndex

    현재 입력이 들어온 출력 커넥터의 인덱스. 이전 노드에 여러 출력이 있는 경우(예: 'If' 또는 'Switch' 노드) 사용합니다.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

  • runIndex

    현재 입력을 생성한 이전 노드의 실행 횟수.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

Root#

  • $(nodeName)

    지정된 노드의 데이터를 반환합니다.

  • $binary

    현재 아이템에 대한 현재 노드의 바이너리 입력 데이터를 반환합니다. $input.item.binary의 약어입니다.

  • $execution

    현재 실행의 메타데이터를 검색하거나 설정합니다.

  • $fromAI(key, description?, type?, defaultValue?)

    대규모 언어 모델이 노드 파라미터의 값을 제공해야 할 때 사용합니다. 더 나은 결과를 위해 설명을 제공하는 것을 고려하세요.

  • $if(condition, valueIfTrue, valueIfFalse)

    condition에 따라 두 값 중 하나를 반환합니다. JavaScript의 ? 연산자와 유사합니다.

  • $ifEmpty(value, valueIfEmpty)

    첫 번째 파라미터가 비어 있지 않으면 반환하고, 그렇지 않으면 두 번째 파라미터를 반환합니다. 다음은 빈 값으로 간주합니다: "", [], {}, null, undefined

  • $input

    현재 노드의 입력 데이터

  • $itemIndex

    입력 아이템 목록에서 현재 처리 중인 아이템의 위치

  • $jmespath(obj, expression)

    JMESPath 표현식을 사용하여 객체(또는 객체 배열)에서 데이터를 추출합니다. 복잡하고 중첩된 객체를 쿼리할 때 유용합니다. 표현식이 유효하지 않으면 undefined를 반환합니다.

  • $json

    현재 아이템에 대한 현재 노드의 JSON 입력 데이터를 반환합니다. $input.item.json의 약어입니다. 자세히 보기

  • $max(num1, num2, …, numN)

    주어진 숫자 중 가장 큰 값을 반환합니다.

  • $min(num1, num2, …, numN)

    주어진 숫자 중 가장 작은 값을 반환합니다.

  • $nodeVersion

    현재 노드의 버전 (노드 설정 창 하단에 표시됨)

  • $now

    현재 순간을 나타내는 DateTime.

워크플로의 타임존을 사용합니다 (워크플로 설정에서 변경 가능).

  • $pageCount

    노드가 가져온 결과 페이지 수. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $parameter

    현재 노드의 구성 설정. 노드 UI에서 입력하는 파라미터입니다 (예: 작업).

  • $prevNode

    현재 입력이 들어온 노드에 대한 정보.

'Merge' 노드에서는 항상 첫 번째 입력 커넥터를 사용합니다.

  • $request

    노드의 마지막 실행 시 전송된 요청 객체. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response

    마지막 HTTP 호출에서 반환된 응답. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $runIndex

    현재 노드 실행의 현재 실행 인덱스. 0부터 시작합니다.

  • $secrets

    구성된 경우 외부 시크릿 볼트의 시크릿. 시크릿 값은 사용자에게 표시되지 않습니다. 자격 증명 필드에서만 사용 가능합니다.

  • $today

    현재 날짜 자정을 나타내는 DateTime.

인스턴스의 타임존을 사용합니다 (워크플로 설정에서 재정의하지 않는 한).

String#

문자열에 다른 내용도 포함된 경우 먼저 extractEmail()이나 extractUrl()을 사용해 보세요.

  • String.extractEmail()

    문자열에서 첫 번째 이메일을 추출합니다. 찾지 못하면 undefined를 반환합니다.

  • String.extractUrl()

    문자열에서 첫 번째 URL을 추출합니다. 찾지 못하면 undefined를 반환합니다. http로 시작하는 전체 URL만 인식합니다.

  • String.extractUrlPath()

    URL에서 도메인 이후 부분을 반환하거나, URL을 찾지 못하면 undefined를 반환합니다.

문자열에 다른 내용도 포함된 경우 먼저 extractUrl()을 사용해 보세요.

  • String.hash(algo?)

    지정된 알고리즘으로 해시된 문자열을 반환합니다. 지정하지 않으면 기본적으로 md5를 사용합니다.

  • String.includes(searchString, start?)

    문자열에 searchString이 포함되어 있으면 true를 반환합니다. 대소문자를 구분합니다.

  • String.indexOf(searchString, start?)

    기본 문자열 내에서 searchString이 처음 나타나는 인덱스(위치)를 반환하고, 찾지 못하면 -1을 반환합니다. 대소문자를 구분합니다.

  • String.isDomain()

    문자열이 도메인이면 true를 반환합니다.

  • String.isEmail()

    문자열이 이메일이면 true를 반환합니다.

  • String.isEmpty()

    문자열에 문자가 없거나 null인 경우 true를 반환합니다.

  • String.isNotEmpty()

    문자열에 하나 이상의 문자가 있으면 true를 반환합니다.

  • String.isNumeric()

    문자열이 숫자를 나타내면 true를 반환합니다.

  • String.isUrl()

    문자열이 유효한 URL이면 true를 반환합니다.

  • String.length

    문자열의 문자 수

  • String.match(regexp)

    정규 표현식에 대해 문자열을 일치시킵니다. 첫 번째 일치 항목을 포함하는 배열을 반환하거나, 정규 표현식에 g 플래그가 설정된 경우 모든 일치 항목을 반환합니다. 일치하는 항목이 없으면 null을 반환합니다.

텍스트가 있는지 확인하려면 includes()를 사용하는 것을 고려하세요.

  • String.parseJson()

    문자열로 표현된 JavaScript Object 또는 값을 반환하거나, 문자열이 유효한 JSON이 아닌 경우 undefined를 반환합니다. 단일 인용 부호 JSON은 지원되지 않습니다.

  • String.quote(mark?)

    문자열을 따옴표로 감싸고, 이미 문자열 안에 있는 따옴표를 이스케이프합니다. JSON, SQL 등을 구성할 때 유용합니다.

  • String.removeMarkdown()

    문자열에서 모든 Markdown 포맷을 제거합니다. HTML 태그도 제거합니다.

  • String.removeTags()

    문자열에서 HTML이나 XML과 같은 태그를 제거합니다.

  • String.replace(pattern, replacement)

    pattern의 첫 번째 발생을 replacement로 대체한 문자열을 반환합니다.

모든 발생을 대체하려면 replaceAll()을 사용하세요.

  • String.replaceAll(pattern, replacement)

    pattern의 모든 발생을 replacement로 대체한 문자열을 반환합니다.

  • String.replaceSpecialChars()

    문자열의 특수 문자를 가장 가까운 ASCII 문자로 대체합니다.

  • String.search(regexp)

    문자열 내에서 패턴이 처음 나타나는 인덱스(위치)를 반환하고, 찾지 못하면 -1을 반환합니다. 패턴은 정규 표현식을 사용하여 지정합니다. 텍스트를 사용하려면 indexOf()를 참조하세요.

  • String.slice(start, end?)

    지정된 위치에서 문자열의 일부를 추출합니다. 더 고급 추출을 위해서는 match()를 참조하세요.

  • String.split(separator?, limit?)

    문자열을 하위 문자열 배열로 분할합니다. 각 분할은 separator에서 이루어지며, 구분자는 출력에 포함되지 않습니다.

배열에 join()을 사용하는 것의 반대 작업입니다.

  • String.startsWith(searchString, start?)

    문자열이 searchString으로 시작하면 true를 반환합니다. 대소문자를 구분합니다.

  • String.substring(start, end?)

    지정된 위치에서 문자열의 일부를 추출합니다. 더 고급 추출을 위해서는 match()를 참조하세요.

  • String.toBoolean()

    문자열을 boolean 값으로 변환합니다. 0, false, nofalse로, 나머지는 모두 true로 변환됩니다. 대소문자를 구분하지 않습니다.

  • String.toDateTime()

    문자열을 DateTime으로 변환합니다. 추가 변환에 유용합니다. 문자열의 지원 형식은 ISO 8601, HTTP, RFC2822, SQL 및 밀리초 단위의 Unix 타임스탬프입니다.

다른 형식을 파싱하려면 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 형식의 코드로 대체됩니다.

WorkflowData#

  • $workflow.active

    워크플로가 활성화되어 있는지 여부

  • $workflow.id

    워크플로 ID. 워크플로 URL에서도 확인할 수 있습니다.

  • $workflow.name

    에디터 상단에 표시되는 워크플로 이름

표현식 레퍼런스

원문 보기
요약

아래는 자주 사용되는 표현식 목록입니다. 아래 표를 탐색하여 데이터 타입별 메서드를 찾으세요. Array.append(elem1, elem2?, ..., elemN?) 배열의 끝에 새 요소를 추가합니다. 배열에 있는 숫자의 평균값을 반환합니다.

아래는 자주 사용되는 표현식 목록입니다. 더 상세한 전체 목록은 아래 표를 참조하세요.

카테고리 표현식 설명
현재 입력 아이템 데이터 접근 $json 현재 아이템의 JSON 데이터
$json.fieldName 현재 아이템의 필드
$binary 현재 아이템의 바이너리 데이터
이전 노드 데이터 접근 $("NodeName").first() 노드의 첫 번째 아이템
$("NodeName").item 노드의 연결된 아이템. 자세한 내용은 아이템 연결을 참조하세요.
$("NodeName").all() 노드의 모든 아이템
$("NodeName").last() 노드의 마지막 아이템
날짜/시간 $now 현재 날짜 및 시간
$today 오늘 날짜
$now.toFormat("yyyy-MM-dd") 현재 날짜를 문자열로 포맷
조건문 $if(condition, "true", "false") 조건이 참 또는 거짓일 때 값을 반환하는 헬퍼 함수
condition ? true : false 삼항 연산자: 조건이 참이면 하나의 값을, 거짓이면 다른 값을 반환
$ifEmpty(value, defaultValue) 두 개의 파라미터를 받아 첫 번째 파라미터가 비어 있는지 확인한 후, 파라미터가 비어 있지 않으면 해당 파라미터를, 비어 있으면 두 번째 파라미터를 반환하는 헬퍼 함수. 첫 번째 파라미터는 undefined, null, 빈 문자열 '', value.lengthfalse를 반환하는 배열, 또는 Object.keys(value).lengthfalse를 반환하는 객체인 경우 비어 있다고 간주함
문자열 메서드 text.toUpperCase() 대문자로 변환
text.toLowerCase() 소문자로 변환
text.includes("foo") 텍스트에 검색어가 포함되어 있는지 확인
text.extractEmail() 텍스트에서 이메일 추출
배열 메서드 array.length 배열 길이 가져오기
array.join(", ") 쉼표를 구분자로 배열 요소 연결
array.filter(x => x <= 20) 필터 조건에 따라 배열 아이템 필터링
array.map(x => x.id) 배열의 아이템 변환

아래 표를 탐색하여 데이터 타입별 메서드를 찾으세요. 메서드 이름을 클릭하면 상세 문서를 확인할 수 있습니다.

Array#

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

  • Array.first()

    배열의 첫 번째 요소를 반환합니다.

  • Array.includes(element, start?)

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

  • Array.indexOf(element, start?)

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

  • Array.intersection(otherArray)

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

  • Array.isEmpty()

    배열에 요소가 없거나 null인 경우 true를 반환합니다.

  • Array.isNotEmpty()

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

  • Array.join(separator?)

    배열의 모든 요소를 하나의 문자열로 합칩니다. 각 요소 사이에 선택적 구분자를 사용할 수 있습니다.

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

  • Array.last()

    배열의 마지막 요소를 반환합니다.

  • Array.length

    배열의 요소 수

  • Array.map(function(element, index?, array?), thisValue?)

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

  • Array.max()

    배열에서 가장 큰 숫자를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.min()

    배열에서 가장 작은 숫자를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.pluck(fieldName1?, fieldName2?, …)

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

  • Array.randomItem()

    배열에서 무작위로 선택한 요소를 반환합니다.

  • Array.reduce(function(prevResult, currentElem, currentIndex?, array?), initResult)

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

  • Array.removeDuplicates(keys?)

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

  • Array.renameKeys(from, to)

    배열 내 Object의 일치하는 키(필드 이름)를 모두 변경합니다. 추가 인수를 사용하여 여러 키를 이름 변경할 수 있습니다. 예: from1, to1, from2, to2, ....

  • Array.reverse()

    배열의 요소 순서를 뒤집습니다.

  • Array.slice(start, end)

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

  • Array.smartJoin(keyField, nameField)

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

  • Array.sort(compareFunction(a, b)?)

    배열의 요소 순서를 재정렬합니다. 알파벳순으로 문자열을 정렬할 때는 파라미터가 필요 없습니다. 숫자나 Object를 정렬하려면 예시를 참조하세요.

  • Array.sum()

    배열의 모든 숫자의 합계를 반환합니다. 숫자가 아닌 요소가 있으면 오류가 발생합니다.

  • Array.toJsonString()

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

  • Array.toSpliced(start, deleteCount, elem1, ....., elemN)

    지정된 위치에서 배열 요소를 추가하거나 제거합니다.

slice()append()도 참조하세요.

  • Array.toString()

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

  • Array.union(otherArray)

    두 배열을 연결한 후 중복을 제거합니다.

  • Array.unique()

    배열에서 중복 요소를 제거합니다.

BinaryFile#

  • binaryFile.directory

    파일이 저장된 디렉토리 경로. 다른 디렉토리에 같은 이름의 파일을 구별할 때 유용합니다. n8n이 데이터베이스에 파일을 저장하도록 구성된 경우에는 설정되지 않습니다.

  • binaryFile.fileExtension

    파일 이름에 붙은 접미사 (예: txt)

  • binaryFile.fileName

    확장자를 포함한 파일 이름

  • binaryFile.fileSize

    파일 크기를 나타내는 문자열

  • binaryFile.fileType

    파일 유형을 나타내는 문자열 (예: image). MIME 타입의 첫 번째 부분에 해당합니다.

  • binaryFile.id

    파일의 고유 ID. 파일이 디스크나 S3 같은 스토리지 서비스에 저장될 때 파일을 식별하는 데 사용됩니다.

  • binaryFile.mimeType

    파일 내용의 형식을 나타내는 문자열 (예: image/jpeg)

Boolean#

  • Boolean.isEmpty()

    모든 boolean에 대해 false를 반환합니다. null에 대해서는 true를 반환합니다.

  • Boolean.toNumber()

    true를 1로, false를 0으로 변환합니다.

  • Boolean.toString()

    true를 문자열 'true'로, false를 문자열 'false'로 변환합니다.

CustomData#

Date#

  • Date.toDateTime()

    JavaScript Date를 Luxon DateTime으로 변환합니다. DateTime은 동일한 정보를 포함하지만 조작하기 더 쉽습니다.

DateTime#

  • DateTime.day

    월의 날짜 (1-31)

  • DateTime.diffTo(otherDateTime, unit)

    지정된 단위로 두 DateTime 간의 차이를 반환합니다.

  • DateTime.diffToNow(unit)

    지정된 단위로 현재 시점과 DateTime 간의 차이를 반환합니다. 텍스트 표현을 원하면 toRelative()를 사용하세요.

  • DateTime.endOf(unit, opts)

    DateTime을 해당 단위의 끝으로 올림합니다. 예: 월말

  • DateTime.equals(other)

    두 DateTime이 정확히 동일한 순간을 나타내고 같은 타임존에 있으면 true를 반환합니다. 덜 엄격한 비교를 위해서는 hasSame()을 사용하세요.

  • DateTime.extract(unit?)

    날짜나 시간의 일부(예: 월)를 숫자로 추출합니다. 텍스트 이름을 추출하려면 format()을 참조하세요.

  • DateTime.format(fmt)

    지정된 형식을 사용하여 DateTime을 문자열로 변환합니다. 포맷 가이드. 일반 형식의 경우 toLocaleString()이 더 간편할 수 있습니다.

  • DateTime.hasSame(otherDateTime, unit)

    두 DateTime이 지정된 단위까지 동일하면 true를 반환합니다. 타임존은 무시되고 로컬 시간만 비교되므로, 필요한 경우 먼저 toUTC()를 사용하세요.

  • DateTime.hour

    하루의 시간 (0-23)

  • DateTime.isBetween(date1, date2)

    DateTime이 지정된 두 시점 사이에 있으면 true를 반환합니다.

  • DateTime.isInDST

    DateTime이 일광 절약 시간제 적용 중인지 여부

  • DateTime.locale

    DateTime의 로케일 (예: 'en-GB'). 로케일은 DateTime을 포맷할 때 사용됩니다.

  • DateTime.millisecond

    초의 밀리초 (0-999)

  • DateTime.minus(n, unit?)

    DateTime에서 지정된 기간을 뺍니다.

  • DateTime.minute

    시간의 분 (0-59)

  • DateTime.month

    월 (1-12)

  • DateTime.monthLong

    텍스트로 된 긴 월 이름 (예: 'October'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.monthShort

    텍스트로 된 축약된 월 이름 (예: 'Oct'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.plus(n, unit?)

    DateTime에 지정된 기간을 더합니다.

  • DateTime.quarter

    연도의 분기 (1-4)

  • DateTime.second

    분의 초 (0-59)

  • DateTime.set(values)

    DateTime의 지정된 단위에 새 값을 할당합니다. DateTime을 반올림하려면 startOf()endOf()도 참조하세요.

  • DateTime.setLocale(locale)

    DateTime의 언어 및 포맷을 결정하는 로케일을 설정합니다. format()이나 toLocaleString()으로 DateTime의 텍스트 표현을 생성할 때 유용합니다.

  • DateTime.setZone(zone, opts)

    DateTime을 지정된 타임존으로 변환합니다. 옵션에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. toLocal()toUTC()도 참조하세요.

  • DateTime.startOf(unit, opts)

    DateTime을 해당 단위의 시작으로 내림합니다. 예: 월의 시작

  • DateTime.toISO(opts)

    DateTime의 ISO 8601 규격 문자열 표현을 반환합니다.

  • DateTime.toLocal()

    DateTime을 워크플로의 로컬 타임존으로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. 워크플로의 타임존은 워크플로 설정에서 변경할 수 있습니다.

  • DateTime.toLocaleString(formatOpts)

    DateTime을 나타내는 현지화된 문자열을 반환합니다. 즉, 해당 로케일에 해당하는 언어와 형식으로 표시됩니다. 지정된 로케일이 없으면 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.toMillis()

    밀리초 단위의 Unix 타임스탬프를 반환합니다 (1970년 1월 1일 이후 경과한 수).

  • DateTime.toRelative(options)

    현재 시간을 기준으로 상대적인 텍스트 표현을 반환합니다 (예: 'in two days'). 기본적으로 내림합니다.

  • DateTime.toSeconds()

    초 단위의 Unix 타임스탬프를 반환합니다 (1970년 1월 1일 이후 경과한 수).

  • DateTime.toString()

    DateTime의 문자열 표현을 반환합니다. toISO()와 유사합니다. 더 많은 포맷 옵션은 format()이나 toLocaleString()을 참조하세요.

  • DateTime.toUTC(offset, opts)

    DateTime을 UTC 타임존으로 변환합니다. 파라미터에서 지정하지 않는 한 DateTime은 여전히 동일한 순간을 나타냅니다. 다른 타임존으로 변환하려면 setZone()을 사용하세요.

  • DateTime.weekday

    요일. 1은 월요일, 7은 일요일입니다.

  • DateTime.weekdayLong

    텍스트로 된 긴 요일 이름 (예: 'Wednesday'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.weekdayShort

    텍스트로 된 축약된 요일 이름 (예: 'Wed'). 로케일이 지정되지 않은 경우 시스템 로케일이 기본값으로 사용됩니다.

  • DateTime.weekNumber

    연도의 주 번호 (1-52 정도)

  • DateTime.year

    연도

  • DateTime.zone

    DateTime과 연결된 타임존

ExecData#

  • $exec.customData

    커스텀 실행 데이터를 설정하고 가져옵니다 (예: 실행 필터링용). 'Execution Data' 노드로도 가능합니다. 자세히 보기

  • $exec.id

    현재 워크플로 실행의 ID

  • $exec.mode

    3가지 값 중 하나가 될 수 있습니다: test (n8n에서 버튼 클릭으로 실행이 트리거됨을 의미), production (자동으로 실행이 트리거됨을 의미). 워크플로 테스트 실행 시에는 evaluation이 사용됩니다.

  • $exec.resumeFormUrl

    'Wait' 노드에서 생성된 폼에 접근하기 위한 URL

  • $exec.resumeUrl

    'Wait' 노드에서 대기 중인 워크플로를 재개하기 위해 호출할 웹훅 URL

HTTPResponse#

  • $response.body

    마지막 HTTP 호출의 응답 객체 본문. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.headers

    마지막 HTTP 호출에서 반환된 헤더. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.statusCode

    마지막 HTTP 호출에서 반환된 HTTP 상태 코드. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response.statusMessage

    요청 상태에 관한 선택적 메시지. 'HTTP Request' 노드에서만 사용 가능합니다.

Item#

NodeInputData#

NodeOutputData#

Number#

  • Number.abs()

    숫자의 절댓값을 반환합니다. 즉, 마이너스 부호를 제거합니다.

  • Number.ceil()

    숫자를 다음 정수로 올림합니다.

  • Number.floor()

    숫자를 가장 가까운 정수로 내림합니다.

  • Number.format(locale?, options?)

    숫자를 나타내는 포맷된 문자열을 반환합니다. 특정 언어나 통화 형식에 유용합니다. Intl.NumberFormat()과 동일합니다.

  • Number.isEmpty()

    모든 숫자에 대해 false를 반환합니다. null에 대해서는 true를 반환합니다.

  • Number.isEven()

    숫자가 짝수이면 true를 반환합니다. 정수가 아닌 경우 오류가 발생합니다.

  • Number.isInteger()

    숫자가 정수이면 true를 반환합니다.

  • Number.isOdd()

    숫자가 홀수이면 true를 반환합니다. 정수가 아닌 경우 오류가 발생합니다.

  • Number.round(decimalPlaces?)

    숫자를 가장 가까운 정수(또는 지정된 소수 자릿수)로 반올림합니다.

  • Number.toBoolean()

    숫자를 boolean 값으로 변환합니다. 0false가 되고, 나머지는 모두 true가 됩니다.

  • Number.toDateTime(format?)

    숫자형 타임스탬프를 DateTime으로 변환합니다. 밀리초가 아닌 경우 타임스탬프 형식을 지정해야 합니다. n8n의 타임존(또는 워크플로 설정의 타임존)을 사용합니다.

  • Number.toLocaleString(locales?, options?)

    숫자를 나타내는 현지화된 문자열을 반환합니다. 즉, 해당 로케일에 해당하는 언어와 형식으로 표시됩니다. 지정된 로케일이 없으면 시스템 로케일이 기본값으로 사용됩니다.

  • Number.toString(radix?)

    숫자를 간단한 텍스트 표현으로 변환합니다. 더 많은 포맷 옵션은 toLocaleString()을 참조하세요.

Object#

  • Object.compact()

    빈 값(null 또는 "")을 가진 모든 필드를 제거합니다.

  • Object.hasField(name)

    name이라는 필드가 있으면 true를 반환합니다. 최상위 키만 확인합니다. 비교는 대소문자를 구분합니다.

  • Object.isEmpty()

    Object에 키(필드)가 설정되어 있지 않거나 null인 경우 true를 반환합니다.

  • Object.isNotEmpty()

    Object에 하나 이상의 키(필드)가 설정되어 있으면 true를 반환합니다.

  • Object.keepFieldsContaining(value)

    값이 지정된 value와 부분적으로도 일치하지 않는 필드를 제거합니다. 비교는 대소문자를 구분합니다. 문자열이 아닌 필드는 항상 제거됩니다.

  • Object.keys()

    객체에 포함된 모든 필드 이름(키)의 배열을 반환합니다. JavaScript의 Object.keys(obj)와 동일합니다.

  • Object.merge(otherObject)

    두 Object를 하나로 병합합니다. 두 Object에 모두 키(필드 이름)가 있는 경우, 첫 번째(기본) Object의 값이 사용됩니다.

  • Object.removeField(key)

    Object에서 필드를 제거합니다. JavaScript의 delete와 동일합니다.

  • Object.removeFieldsContaining(value)

    값이 지정된 value와 부분적으로 일치하는 키(필드)를 제거합니다. 비교는 대소문자를 구분합니다. 문자열이 아닌 필드는 항상 유지됩니다.

  • Object.toJsonString()

    Object를 JSON 문자열로 변환합니다. JavaScript의 JSON.stringify()와 유사합니다.

  • Object.urlEncode()

    Object의 키와 값으로 URL 파라미터 문자열을 생성합니다. 최상위 키만 지원됩니다.

  • Object.values()

    Object에 포함된 모든 필드의 값 배열을 반환합니다. JavaScript의 Object.values(obj)와 동일합니다.

PrevNodeData#

  • name

    현재 입력이 들어온 노드의 이름.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

  • outputIndex

    현재 입력이 들어온 출력 커넥터의 인덱스. 이전 노드에 여러 출력이 있는 경우(예: 'If' 또는 'Switch' 노드) 사용합니다.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

  • runIndex

    현재 입력을 생성한 이전 노드의 실행 횟수.

입력 커넥터가 여러 개인 경우(예: 'Merge' 노드) 항상 현재 노드의 첫 번째 입력 커넥터를 사용합니다.

Root#

  • $(nodeName)

    지정된 노드의 데이터를 반환합니다.

  • $binary

    현재 아이템에 대한 현재 노드의 바이너리 입력 데이터를 반환합니다. $input.item.binary의 약어입니다.

  • $execution

    현재 실행의 메타데이터를 검색하거나 설정합니다.

  • $fromAI(key, description?, type?, defaultValue?)

    대규모 언어 모델이 노드 파라미터의 값을 제공해야 할 때 사용합니다. 더 나은 결과를 위해 설명을 제공하는 것을 고려하세요.

  • $if(condition, valueIfTrue, valueIfFalse)

    condition에 따라 두 값 중 하나를 반환합니다. JavaScript의 ? 연산자와 유사합니다.

  • $ifEmpty(value, valueIfEmpty)

    첫 번째 파라미터가 비어 있지 않으면 반환하고, 그렇지 않으면 두 번째 파라미터를 반환합니다. 다음은 빈 값으로 간주합니다: "", [], {}, null, undefined

  • $input

    현재 노드의 입력 데이터

  • $itemIndex

    입력 아이템 목록에서 현재 처리 중인 아이템의 위치

  • $jmespath(obj, expression)

    JMESPath 표현식을 사용하여 객체(또는 객체 배열)에서 데이터를 추출합니다. 복잡하고 중첩된 객체를 쿼리할 때 유용합니다. 표현식이 유효하지 않으면 undefined를 반환합니다.

  • $json

    현재 아이템에 대한 현재 노드의 JSON 입력 데이터를 반환합니다. $input.item.json의 약어입니다. 자세히 보기

  • $max(num1, num2, …, numN)

    주어진 숫자 중 가장 큰 값을 반환합니다.

  • $min(num1, num2, …, numN)

    주어진 숫자 중 가장 작은 값을 반환합니다.

  • $nodeVersion

    현재 노드의 버전 (노드 설정 창 하단에 표시됨)

  • $now

    현재 순간을 나타내는 DateTime.

워크플로의 타임존을 사용합니다 (워크플로 설정에서 변경 가능).

  • $pageCount

    노드가 가져온 결과 페이지 수. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $parameter

    현재 노드의 구성 설정. 노드 UI에서 입력하는 파라미터입니다 (예: 작업).

  • $prevNode

    현재 입력이 들어온 노드에 대한 정보.

'Merge' 노드에서는 항상 첫 번째 입력 커넥터를 사용합니다.

  • $request

    노드의 마지막 실행 시 전송된 요청 객체. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $response

    마지막 HTTP 호출에서 반환된 응답. 'HTTP Request' 노드에서만 사용 가능합니다.

  • $runIndex

    현재 노드 실행의 현재 실행 인덱스. 0부터 시작합니다.

  • $secrets

    구성된 경우 외부 시크릿 볼트의 시크릿. 시크릿 값은 사용자에게 표시되지 않습니다. 자격 증명 필드에서만 사용 가능합니다.

  • $today

    현재 날짜 자정을 나타내는 DateTime.

인스턴스의 타임존을 사용합니다 (워크플로 설정에서 재정의하지 않는 한).

String#

문자열에 다른 내용도 포함된 경우 먼저 extractEmail()이나 extractUrl()을 사용해 보세요.

  • String.extractEmail()

    문자열에서 첫 번째 이메일을 추출합니다. 찾지 못하면 undefined를 반환합니다.

  • String.extractUrl()

    문자열에서 첫 번째 URL을 추출합니다. 찾지 못하면 undefined를 반환합니다. http로 시작하는 전체 URL만 인식합니다.

  • String.extractUrlPath()

    URL에서 도메인 이후 부분을 반환하거나, URL을 찾지 못하면 undefined를 반환합니다.

문자열에 다른 내용도 포함된 경우 먼저 extractUrl()을 사용해 보세요.

  • String.hash(algo?)

    지정된 알고리즘으로 해시된 문자열을 반환합니다. 지정하지 않으면 기본적으로 md5를 사용합니다.

  • String.includes(searchString, start?)

    문자열에 searchString이 포함되어 있으면 true를 반환합니다. 대소문자를 구분합니다.

  • String.indexOf(searchString, start?)

    기본 문자열 내에서 searchString이 처음 나타나는 인덱스(위치)를 반환하고, 찾지 못하면 -1을 반환합니다. 대소문자를 구분합니다.

  • String.isDomain()

    문자열이 도메인이면 true를 반환합니다.

  • String.isEmail()

    문자열이 이메일이면 true를 반환합니다.

  • String.isEmpty()

    문자열에 문자가 없거나 null인 경우 true를 반환합니다.

  • String.isNotEmpty()

    문자열에 하나 이상의 문자가 있으면 true를 반환합니다.

  • String.isNumeric()

    문자열이 숫자를 나타내면 true를 반환합니다.

  • String.isUrl()

    문자열이 유효한 URL이면 true를 반환합니다.

  • String.length

    문자열의 문자 수

  • String.match(regexp)

    정규 표현식에 대해 문자열을 일치시킵니다. 첫 번째 일치 항목을 포함하는 배열을 반환하거나, 정규 표현식에 g 플래그가 설정된 경우 모든 일치 항목을 반환합니다. 일치하는 항목이 없으면 null을 반환합니다.

텍스트가 있는지 확인하려면 includes()를 사용하는 것을 고려하세요.

  • String.parseJson()

    문자열로 표현된 JavaScript Object 또는 값을 반환하거나, 문자열이 유효한 JSON이 아닌 경우 undefined를 반환합니다. 단일 인용 부호 JSON은 지원되지 않습니다.

  • String.quote(mark?)

    문자열을 따옴표로 감싸고, 이미 문자열 안에 있는 따옴표를 이스케이프합니다. JSON, SQL 등을 구성할 때 유용합니다.

  • String.removeMarkdown()

    문자열에서 모든 Markdown 포맷을 제거합니다. HTML 태그도 제거합니다.

  • String.removeTags()

    문자열에서 HTML이나 XML과 같은 태그를 제거합니다.

  • String.replace(pattern, replacement)

    pattern의 첫 번째 발생을 replacement로 대체한 문자열을 반환합니다.

모든 발생을 대체하려면 replaceAll()을 사용하세요.

  • String.replaceAll(pattern, replacement)

    pattern의 모든 발생을 replacement로 대체한 문자열을 반환합니다.

  • String.replaceSpecialChars()

    문자열의 특수 문자를 가장 가까운 ASCII 문자로 대체합니다.

  • String.search(regexp)

    문자열 내에서 패턴이 처음 나타나는 인덱스(위치)를 반환하고, 찾지 못하면 -1을 반환합니다. 패턴은 정규 표현식을 사용하여 지정합니다. 텍스트를 사용하려면 indexOf()를 참조하세요.

  • String.slice(start, end?)

    지정된 위치에서 문자열의 일부를 추출합니다. 더 고급 추출을 위해서는 match()를 참조하세요.

  • String.split(separator?, limit?)

    문자열을 하위 문자열 배열로 분할합니다. 각 분할은 separator에서 이루어지며, 구분자는 출력에 포함되지 않습니다.

배열에 join()을 사용하는 것의 반대 작업입니다.

  • String.startsWith(searchString, start?)

    문자열이 searchString으로 시작하면 true를 반환합니다. 대소문자를 구분합니다.

  • String.substring(start, end?)

    지정된 위치에서 문자열의 일부를 추출합니다. 더 고급 추출을 위해서는 match()를 참조하세요.

  • String.toBoolean()

    문자열을 boolean 값으로 변환합니다. 0, false, nofalse로, 나머지는 모두 true로 변환됩니다. 대소문자를 구분하지 않습니다.

  • String.toDateTime()

    문자열을 DateTime으로 변환합니다. 추가 변환에 유용합니다. 문자열의 지원 형식은 ISO 8601, HTTP, RFC2822, SQL 및 밀리초 단위의 Unix 타임스탬프입니다.

다른 형식을 파싱하려면 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 형식의 코드로 대체됩니다.

WorkflowData#

  • $workflow.active

    워크플로가 활성화되어 있는지 여부

  • $workflow.id

    워크플로 ID. 워크플로 URL에서도 확인할 수 있습니다.

  • $workflow.name

    에디터 상단에 표시되는 워크플로 이름