Довідник помічників Handlebars

Будь-який вираз у Restorm є шаблоном Handlebars: URL, заголовок, параметр, тіло запиту, змінна середовища типу Вираз, поле сценарію, шаблон дії Transform template.

Ця сторінка перелічує 116 іменованих помічників і 22 динамічні змінні.

Ctrl+Space викликає автодоповнення в полях, які його підтримують.

Порівняння (15)

Помічник	Підпис	Дія
`eq`	`{{eq a b}}`	`a === b`
`ne`	`{{ne a b}}`	`a !== b`
`neq`	`{{neq a b}}`	Псевдонім `ne`
`lt`	`{{lt a b}}`	`a < b` (числове)
`lte`	`{{lte a b}}`	`a <= b`
`gt`	`{{gt a b}}`	`a > b`
`gte`	`{{gte a b}}`	`a >= b`
`and`	`{{#and a b}}…{{else}}…{{/and}}`	Блок: усі аргументи істинні
`or`	`{{#or a b}}…{{/or}}`	Блок: істинний принаймні один аргумент
`not`	`{{not value}}`	Заперечення
`ifEquals`	`{{#ifEquals a b}}…{{else}}…{{/ifEquals}}`	Блок, сувора рівність
`is`	`{{#is a b}}…{{/is}}`	Блок, порівняння як рядків
`isnt`	`{{#isnt a b}}…{{/isnt}}`	Блок, відмінність як рядків
`default`	`{{default value fallback}}`	`value`, якщо визначено, інакше `fallback`
`compare`	`{{#compare a "op" b}}…{{/compare}}`	Блок; `op` ∈ `==` `===` `!=` `!==` `<` `<=` `>` `>=`

{{default region "eu-west-1"}}
{{#compare quantite ">" 100}}gros{{else}}normal{{/compare}}

Рядки (37)

Помічник	Підпис	Приклад → результат
`lowercase`	`{{lowercase s}}`	`Bonjour` → `bonjour`
`uppercase`	`{{uppercase s}}`	`Bonjour` → `BONJOUR`
`capitalize`	`{{capitalize s}}`	`bonjour tout` → `Bonjour tout`
`capitalizeAll`	`{{capitalizeAll s}}`	`bonjour tout` → `Bonjour Tout`
`titleize`	`{{titleize s}}`	Те саме, що `capitalizeAll`
`camelcase`	`{{camelcase s}}`	`mon-champ` → `monChamp`
`pascalcase`	`{{pascalcase s}}`	`mon-champ` → `MonChamp`
`snakecase`	`{{snakecase s}}`	`monChamp` → `mon_champ`
`snakeCase`	`{{snakeCase s}}`	Псевдонім `snakecase`
`dashcase`	`{{dashcase s}}`	`monChamp` → `mon-champ`
`dotcase`	`{{dotcase s}}`	`monChamp` → `mon.champ`
`pathcase`	`{{pathcase s}}`	`monChamp` → `mon/champ`
`sentencecase`	`{{sentencecase s}}`	`BONJOUR TOUT` → `Bonjour tout`
`slugify`	`{{slugify s}}`	`Mon Beau Titre !` → `mon-beau-titre`
`trim`	`{{trim s}}`	Прибирає пробіли з обох боків
`trimLeft`	`{{trimLeft s}}`	Ліворуч
`trimRight`	`{{trimRight s}}`	Праворуч
`replace`	`{{replace s search replacement}}`	Замінює всі входження (буквально, без регулярних виразів)
`split`	`{{split s separator}}`	Розбиває на масив; типовий роздільник — `,`
`truncate`	`{{truncate s length suffix}}`	Типово довжина 50 і суфікс `...`
`ellipsis`	`{{ellipsis s length}}`	Як `truncate`, але з `…`
`append`	`{{append s suffix}}`	Дописує в кінець
`prepend`	`{{prepend s prefix}}`	Дописує на початок
`reverse`	`{{reverse value}}`	Обертає рядок або масив
`startsWith`	`{{#startsWith s prefix}}…{{/startsWith}}`	Блок
`endsWith`	`{{#endsWith s suffix}}…{{/endsWith}}`	Блок
`contains`	`{{#contains stringOrArray value}}…{{/contains}}`	Блок
`match`	`{{match s pattern}}`	Усі збіги або `null`
`test`	`{{#test s pattern}}…{{/test}}`	Блок, перевірка регулярним виразом
`padStart`	`{{padStart s length character}}`	Доповнює ліворуч
`padEnd`	`{{padEnd s length character}}`	Доповнює праворуч
`repeat`	`{{repeat s n}}`	Повторює
`substring`	`{{substring s start end}}`	Вилучає частину
`indexOf`	`{{indexOf s search}}`	Позиція або `-1`
`count`	`{{count s substring}}`	Кількість входжень
`newLineToBr`	`{{newLineToBr s}}`	`\n` → `<br>`
`stripTags`	`{{stripTags s}}`	Прибирає теги `<…>`

{{slugify nomProduit}}
{{padStart numeroCommande 8 "0"}}
{{truncate description 120}}

Математика (19)

Помічник	Підпис	Дія
`add`	`{{add a b}}`	Сума
`subtract`	`{{subtract a b}}`	Різниця
`multiply`	`{{multiply a b}}`	Добуток
`divide`	`{{divide a b}}`	Частка
`modulo`	`{{modulo a b}}`	Остача
`abs`	`{{abs a}}`	Модуль
`ceil`	`{{ceil a}}`	Округлення вгору
`floor`	`{{floor a}}`	Округлення вниз
`round`	`{{round a}}`	Округлення
`pow`	`{{pow base exponent}}`	Степінь
`sqrt`	`{{sqrt a}}`	Квадратний корінь
`random`	`{{random min max}}`	Випадкове ціле, межі включно
`sum`	`{{sum array}}`	Сума масиву
`avg`	`{{avg array}}`	Середнє
`min`	`{{min a b c …}}`	Мінімум, змінна кількість аргументів
`max`	`{{max a b c …}}`	Максимум, змінна кількість аргументів
`toFixed`	`{{toFixed number decimals}}`	Рядок із N десятковими знаками
`toInt`	`{{toInt number}}`	Ціле (основа 10), `0` як запасне значення
`toFloat`	`{{toFloat number}}`	Число з рухомою комою, `0` як запасне значення

{"montantTTC": {{toFixed (multiply montantHT 1.2) 2}}}

Масиви (18)

Помічник	Підпис	Дія
`first`	`{{first array n}}`	Перший елемент або перші `n`
`last`	`{{last array n}}`	Останній або останні `n`
`length`	`{{length value}}`	Довжина масиву чи рядка або кількість ключів
`join`	`{{join array separator}}`	Типовий роздільник — `,`
`sort`	`{{sort array}}`	Відсортована копія
`unique`	`{{unique array}}`	Прибирає дублікати
`after`	`{{after array n}}`	Усе після індексу `n`
`before`	`{{before array n}}`	Усе до індексу `n`
`slice`	`{{slice array start end}}`	Частина
`concat`	`{{concat a b …}}`	З’єднує, сплощуючи на один рівень
`flatten`	`{{flatten array}}`	Сплощує на один рівень
`pluck`	`{{pluck array property}}`	Вилучає одну властивість із кожного елемента
`itemAt`	`{{itemAt array index}}`	Елемент за індексом; від’ємний індекс рахується з кінця
`inArray`	`{{#inArray array value}}…{{/inArray}}`	Блок
`isArray`	`{{isArray value}}`	Булеве значення
`isEmpty`	`{{#isEmpty value}}…{{/isEmpty}}`	Блок
`some`	`{{#some array prop value}}…{{/some}}`	Блок: збігається принаймні один елемент
`every`	`{{#every array prop value}}…{{/every}}`	Блок: збігаються всі елементи

{{join (pluck articles "reference") ","}}

Об’єкти (12)

Помічник	Підпис	Дія
`JSONstringify`	`{{JSONstringify obj}}`	Серіалізує з відступом 2
`JSONparse`	`{{JSONparse string}}`	Розбирає; `{}` у разі невдачі
`get`	`{{get obj "a.b.c"}}`	Читання за шляхом із крапками
`isObject`	`{{isObject value}}`	Булеве значення (не null, не масив)
`typeOf`	`{{typeOf value}}`	`null`, `array` або тип JavaScript
`keys`	`{{keys obj}}`	Ключі
`values`	`{{values obj}}`	Значення
`entries`	`{{entries obj}}`	Пари `[ключ, значення]`
`hasOwn`	`{{#hasOwn obj "key"}}…{{/hasOwn}}`	Блок
`pick`	`{{pick obj "k1" "k2"}}`	Залишає лише ці ключі
`omit`	`{{omit obj "k1"}}`	Прибирає ці ключі
`merge`	`{{merge o1 o2}}`	Поверхневе злиття

{{get reponse "data.client.identifiant"}}

URL (5)

Помічник	Підпис	Дія
`encodeURI`	`{{encodeURI s}}`	Кодує складник URL
`decodeURI`	`{{decodeURI s}}`	Декодує
`urlParse`	`{{urlParse url}}`	`{ href, origin, protocol, host, hostname, port, pathname, search, hash }` або `null`
`stripQuerystring`	`{{stripQuerystring url}}`	Прибирає рядок запиту
`stripProtocol`	`{{stripProtocol url}}`	Прибирає схему

{{baseUrl}}/recherche?q={{encodeURI termeRecherche}}

Дати (4)

Помічник	Підпис	Дія
`year`	`{{year}}`	Поточний рік
`now`	`{{now}}`	Поточний момент у форматі ISO
`timestamp`	`{{timestamp}}`	Поточний момент у мілісекундах
`formatDate`	`{{formatDate date "YYYY-MM-DD"}}`	Форматує

Зауважте також, що {{timestamp}} подається в мілісекундах, тоді як {{$timestamp}} (сумісність із Postman, нижче) — у секундах.

Різне (6)

Помічник	Підпис	Дія
`coalesce`	`{{coalesce a b c}}`	Перше значення, відмінне від null
`uuid`	`{{uuid}}`	UUID v4
`noop`	`{{#noop}}…{{/noop}}`	Блок без наслідків
`raw`	`{{{{raw}}}}…{{{{/raw}}}}`	Не тлумачить вміст
`times`	`{{#times n}}…{{/times}}`	Повторює блок; доступні `@index`, `@first`, `@last`
`range`	`{{range start end step}}`	Масив чисел, кінець виключено

Помічник raw — саме те, що потрібно, коли ви навмисно надсилаєте подвійні фігурні дужки, наприклад щоб перевірити службу, яка сама їх тлумачить.

Динамічні змінні (сумісність із Postman) (22)

Без аргументів, інше значення при кожному обчисленні.

Змінна	Повертає
`{{$guid}}`	UUID v4
`{{$randomUUID}}`	UUID v4
`{{$timestamp}}`	Поточний момент у секундах
`{{$isoTimestamp}}`	Поточний момент у форматі ISO
`{{$randomInt}}`	Ціле від 0 до 1000
`{{$randomAlphaNumeric}}`	8 літерно-цифрових символів
`{{$randomBoolean}}`	`true` або `false`
`{{$randomFirstName}}`	Ім’я
`{{$randomLastName}}`	Прізвище
`{{$randomFullName}}`	Повне ім’я
`{{$randomUserName}}`	`ім'я.прізвище<0-99>`
`{{$randomEmail}}`	Адресу електронної пошти
`{{$randomColor}}`	Назву кольору
`{{$randomWord}}`	Слово
`{{$randomWords}}`	Три слова
`{{$randomCompanyName}}`	Назву компанії
`{{$randomCity}}`	Місто
`{{$randomCountry}}`	Країну
`{{$randomPhoneNumber}}`	Номер телефону
`{{$randomIP}}`	IP-адресу
`{{$randomIPV4}}`	Адресу IPv4
`{{$randomPrice}}`	Ціну з двома десятковими знаками

{
  "correlationId": "{{$guid}}",
  "client": { "nom": "{{$randomFullName}}", "email": "{{$randomEmail}}" },
  "emisLe": "{{$isoTimestamp}}"
}

Доступ до змінних середовища

Помічника для доступу до змінних не існує: вони й так є в контексті. Пишуть {{baseUrl}}, а не {{env "baseUrl"}}.

Див. Змінні та середовища.