InfoGrab DocsInfoGrab 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?, …)

    배열의 각 객체에서 지정된 필드의 값들을 담은 배열을 반환합니다. 객체가 아니거나 제공된 필드 이름과 일치하는 키가 없는 배열 요소는 무시합니다.

  • Array.randomItem()

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

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

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

  • Array.removeDuplicates(keys?)

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

  • Array.renameKeys(from, to)

    배열에 있는 모든 객체에서 일치하는 키(필드 이름)를 변경합니다. 인수를 추가하여 두 개 이상의 키 이름을 변경할 수 있습니다. 즉 from1, to1, from2, to2, ... 형식입니다.

  • Array.reverse()

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

  • Array.slice(start, end)

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

  • Array.smartJoin(keyField, nameField)

    객체 배열로부터 단일 객체를 생성합니다. 배열의 각 객체는 반환되는 객체에 하나의 필드를 제공합니다. 배열의 각 객체는 키 이름을 가진 필드와 값을 가진 필드를 반드시 포함해야 합니다.

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

    배열의 요소를 재정렬합니다. 문자열을 알파벳순으로 정렬할 때는 파라미터가 필요하지 않습니다. 숫자나 객체를 정렬할 때는 예제를 참조하세요.

  • 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()

    모든 불리언에 대해 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

    'en-GB'와 같은 DateTime의 로케일입니다. 로케일은 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

    세 가지 값 중 하나가 될 수 있습니다. 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#

Object#

  • Object.compact()

    빈 값, 즉 null이거나 ""인 모든 필드를 제거합니다

  • Object.hasField(name)

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

  • Object.isEmpty()

    객체에 설정된 키(필드)가 없거나 null이면 true를 반환합니다

  • Object.isNotEmpty()

    객체에 설정된 키(필드)가 하나 이상 있으면 true를 반환합니다

  • Object.keepFieldsContaining(value)

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

  • Object.keys()

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

  • Object.merge(otherObject)

    두 객체를 하나로 병합합니다. 키(필드 이름)가 두 객체 모두에 존재하면 첫 번째(기본) 객체의 값이 사용됩니다.

  • Object.removeField(key)

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

  • Object.removeFieldsContaining(value)

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

  • Object.toJsonString()

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

  • Object.urlEncode()

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

  • Object.values()

    객체가 포함하는 모든 필드 값이 담긴 배열을 반환합니다. 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)

    <a href=”/code/cookbook/jmespath/”>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입니다.

인스턴스의 시간대를 사용합니다(워크플로 설정에서 재정의하지 않는 한).

  • $vars

    워크플로에서 사용할 수 있는 변수

  • $workflow

    현재 워크플로에 대한 정보

String#

문자열에 다른 내용도 포함되어 있으면 먼저 extractEmail()이나 extractUrl()을 사용해 보세요.

  • String.extractEmail()

    문자열에서 처음 발견된 이메일을 추출합니다. 없으면 undefined를 반환합니다.

  • String.extractUrl()

    문자열에서 처음 발견된 URL을 추출합니다. 없으면 undefined를 반환합니다. http로 시작하는 것과 같은 전체 URL만 인식합니다.

  • String.extractUrlPath()

    URL에서 도메인 뒤의 부분을 반환하며, URL을 찾지 못하면 undefined를 반환합니다.

문자열에 다른 내용도 포함되어 있으면 먼저 extractUrl()을 사용해 보세요.

텍스트가 존재하는지 확인하려면 includes()를 고려하세요.

  • String.parseJson()

    문자열이 나타내는 JavaScript 객체나 값을 반환하며, 문자열이 유효한 JSON이 아니면 undefined를 반환합니다. 작은따옴표로 감싼 JSON은 지원되지 않습니다.

  • String.quote(mark?)

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

  • String.removeMarkdown()

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

  • String.removeTags()

    문자열에서 HTML이나 XML 등의 태그를 제거합니다

  • String.replace(pattern, replacement)

    pattern이 처음 나타나는 부분을 replacement로 대체한 문자열을 반환합니다.

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

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

  • String.startsWith(searchString, start?)

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

  • String.substring(start, end?)

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

  • String.toBoolean()

    문자열을 불리언 값으로 변환합니다. 0, false, nofalse로, 그 외의 모든 값은 true로 해석됩니다. 대소문자를 구분하지 않습니다.

  • String.toDateTime()

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

다른 형식을 파싱하려면 <a href=”https://moment.github.io/luxon/api-docs/index.html#datetimefromformat”> DateTime.fromFormat()을 사용하세요.

  • String.toJsonString()

    문자열을 JSON 객체에 삽입할 수 있도록 준비합니다. 따옴표와 특수 문자(예: 줄바꿈)를 이스케이프하고 문자열을 따옴표로 감쌉니다.

JavaScript의 JSON.stringify()와 동일합니다.

  • String.toLowerCase()

    문자열의 모든 문자를 소문자로 변환합니다

  • String.toNumber()

    숫자를 나타내는 문자열을 숫자로 변환합니다. 문자열이 유효한 숫자로 시작하지 않으면 오류가 발생합니다.

  • String.toSentenceCase()

    문자열의 대소문자를 문장 형식(sentence case)으로 변경합니다. 각 문장의 첫 글자는 대문자로, 나머지는 모두 소문자로 처리됩니다.

  • String.toSnakeCase()

    문자열의 형식을 스네이크 케이스(snake case)로 변경합니다. 공백과 대시는 _로 대체되고, 기호는 제거되며, 모든 문자는 소문자로 처리됩니다.

  • String.toTitleCase()

    문자열의 대소문자를 타이틀 형식(title case)으로 변경합니다. 각 단어의 첫 글자는 대문자로, 나머지는 그대로 둡니다. 짧은 전치사와 접속사는 대문자로 처리하지 않습니다(예: '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

    편집기 상단에 표시되는 워크플로의 이름

표현식 레퍼런스

n8n v2.29
원문 보기
요약

다음은 자주 사용되는 표현식입니다. 아래 표를 살펴보면서 각 메서드가 작동하는 데이터 타입별로 메서드를 찾아보세요. 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?, …)

    배열의 각 객체에서 지정된 필드의 값들을 담은 배열을 반환합니다. 객체가 아니거나 제공된 필드 이름과 일치하는 키가 없는 배열 요소는 무시합니다.

  • Array.randomItem()

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

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

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

  • Array.removeDuplicates(keys?)

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

  • Array.renameKeys(from, to)

    배열에 있는 모든 객체에서 일치하는 키(필드 이름)를 변경합니다. 인수를 추가하여 두 개 이상의 키 이름을 변경할 수 있습니다. 즉 from1, to1, from2, to2, ... 형식입니다.

  • Array.reverse()

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

  • Array.slice(start, end)

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

  • Array.smartJoin(keyField, nameField)

    객체 배열로부터 단일 객체를 생성합니다. 배열의 각 객체는 반환되는 객체에 하나의 필드를 제공합니다. 배열의 각 객체는 키 이름을 가진 필드와 값을 가진 필드를 반드시 포함해야 합니다.

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

    배열의 요소를 재정렬합니다. 문자열을 알파벳순으로 정렬할 때는 파라미터가 필요하지 않습니다. 숫자나 객체를 정렬할 때는 예제를 참조하세요.

  • 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()

    모든 불리언에 대해 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

    'en-GB'와 같은 DateTime의 로케일입니다. 로케일은 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

    세 가지 값 중 하나가 될 수 있습니다. 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#

Object#

  • Object.compact()

    빈 값, 즉 null이거나 ""인 모든 필드를 제거합니다

  • Object.hasField(name)

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

  • Object.isEmpty()

    객체에 설정된 키(필드)가 없거나 null이면 true를 반환합니다

  • Object.isNotEmpty()

    객체에 설정된 키(필드)가 하나 이상 있으면 true를 반환합니다

  • Object.keepFieldsContaining(value)

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

  • Object.keys()

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

  • Object.merge(otherObject)

    두 객체를 하나로 병합합니다. 키(필드 이름)가 두 객체 모두에 존재하면 첫 번째(기본) 객체의 값이 사용됩니다.

  • Object.removeField(key)

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

  • Object.removeFieldsContaining(value)

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

  • Object.toJsonString()

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

  • Object.urlEncode()

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

  • Object.values()

    객체가 포함하는 모든 필드 값이 담긴 배열을 반환합니다. 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)

    <a href=”/code/cookbook/jmespath/”>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입니다.

인스턴스의 시간대를 사용합니다(워크플로 설정에서 재정의하지 않는 한).

  • $vars

    워크플로에서 사용할 수 있는 변수

  • $workflow

    현재 워크플로에 대한 정보

String#

문자열에 다른 내용도 포함되어 있으면 먼저 extractEmail()이나 extractUrl()을 사용해 보세요.

  • String.extractEmail()

    문자열에서 처음 발견된 이메일을 추출합니다. 없으면 undefined를 반환합니다.

  • String.extractUrl()

    문자열에서 처음 발견된 URL을 추출합니다. 없으면 undefined를 반환합니다. http로 시작하는 것과 같은 전체 URL만 인식합니다.

  • String.extractUrlPath()

    URL에서 도메인 뒤의 부분을 반환하며, URL을 찾지 못하면 undefined를 반환합니다.

문자열에 다른 내용도 포함되어 있으면 먼저 extractUrl()을 사용해 보세요.

텍스트가 존재하는지 확인하려면 includes()를 고려하세요.

  • String.parseJson()

    문자열이 나타내는 JavaScript 객체나 값을 반환하며, 문자열이 유효한 JSON이 아니면 undefined를 반환합니다. 작은따옴표로 감싼 JSON은 지원되지 않습니다.

  • String.quote(mark?)

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

  • String.removeMarkdown()

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

  • String.removeTags()

    문자열에서 HTML이나 XML 등의 태그를 제거합니다

  • String.replace(pattern, replacement)

    pattern이 처음 나타나는 부분을 replacement로 대체한 문자열을 반환합니다.

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

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

  • String.startsWith(searchString, start?)

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

  • String.substring(start, end?)

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

  • String.toBoolean()

    문자열을 불리언 값으로 변환합니다. 0, false, nofalse로, 그 외의 모든 값은 true로 해석됩니다. 대소문자를 구분하지 않습니다.

  • String.toDateTime()

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

다른 형식을 파싱하려면 <a href=”https://moment.github.io/luxon/api-docs/index.html#datetimefromformat”> DateTime.fromFormat()을 사용하세요.

  • String.toJsonString()

    문자열을 JSON 객체에 삽입할 수 있도록 준비합니다. 따옴표와 특수 문자(예: 줄바꿈)를 이스케이프하고 문자열을 따옴표로 감쌉니다.

JavaScript의 JSON.stringify()와 동일합니다.

  • String.toLowerCase()

    문자열의 모든 문자를 소문자로 변환합니다

  • String.toNumber()

    숫자를 나타내는 문자열을 숫자로 변환합니다. 문자열이 유효한 숫자로 시작하지 않으면 오류가 발생합니다.

  • String.toSentenceCase()

    문자열의 대소문자를 문장 형식(sentence case)으로 변경합니다. 각 문장의 첫 글자는 대문자로, 나머지는 모두 소문자로 처리됩니다.

  • String.toSnakeCase()

    문자열의 형식을 스네이크 케이스(snake case)로 변경합니다. 공백과 대시는 _로 대체되고, 기호는 제거되며, 모든 문자는 소문자로 처리됩니다.

  • String.toTitleCase()

    문자열의 대소문자를 타이틀 형식(title case)으로 변경합니다. 각 단어의 첫 글자는 대문자로, 나머지는 그대로 둡니다. 짧은 전치사와 접속사는 대문자로 처리하지 않습니다(예: '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

    편집기 상단에 표시되는 워크플로의 이름