Строковые трансформеры (String)
Операторы, перестраивающие текст. Строковые операторы используют контракт
per-item (кроме split, превращающего одну строку в массив, и join,
ориентированного на массив): скалярная строка преобразуется напрямую, а над
массивом преобразуется каждый строковый элемент, тогда как нестроковые элементы
проходят насквозь.
htmlToText
Вид: трансформер · Обработка значения: whole-value
Удаляет HTML-разметку и декодирует распространённые сущности в читаемый обычный текст.
Поведение. Удаляет блоки <style>/<script>, преобразует <br> в перевод
строки, а </p> — в пустую строку, отбрасывает все прочие теги, декодирует
, &, <, > и схлопывает лишние пробелы.
Крайние случаи. Нестроковый вход проходит насквозь без изменений.
Пример. "<p>Hi</p>" → "Hi"
trim
Вид: трансформер · Обработка значения: per-item · Синоним: mapper_trim
Удаляет начальные и конечные пробелы.
Крайние случаи. Над массивом обрезает строковые элементы и оставляет нестроковые нетронутыми.
Пример. " x " → "x" · [" a ", 1, " b "] → ["a", 1, "b"]
trimStart
Вид: трансформер · Обработка значения: per-item
Удаляет только начальные пробелы.
Пример. " hello " → "hello "
trimEnd
Вид: трансформер · Обработка значения: per-item
Удаляет только конечные пробелы.
Пример. " hello " → " hello"
toLowerCase
Вид: трансформер · Обработка значения: per-item · Синоним: mapper_toLowerCase
Приводит строковые значения к нижнему регистру.
Пример. "AbC" → "abc"
toUpperCase
Вид: трансформер · Обработка значения: per-item · Синоним: mapper_toUpperCase
Приводит строковые значения к верхнему регистру.
Пример. "AbC" → "ABC"
substring
Вид: трансформер · Обработка значения: per-item
Извлекает подстроку по начальному индексу и опциональному конечному индексу.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
start |
number | да | 0 |
end |
number | нет | конец строки |
Поведение. Использует String.substring(start, end); end не включается.
Пример. "abcdef" с start=1, end=4 → "bcd"
split
Вид: трансформер · Обработка значения: whole-value
Разбивает строку в массив по разделителю.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
delimiter |
string | нет | , |
Крайние случаи. Нестроковый вход проходит насквозь без изменений.
Пример. "a|b" с delimiter="|" → ["a", "b"]
join
Вид: трансформер · Обработка значения: array
Соединяет элементы массива в строку с разделителем (каждый элемент приводится к
тексту; null/undefined становятся пустой строкой).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
separator |
string | нет | , |
Пример. ["a", "b"] с separator="-" → "a-b"
replace
Вид: трансформер · Обработка значения: per-item
Заменяет все совпадения регулярного выражения (применяется с глобальным флагом).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
regex |
string (regex) | да | — |
replaceWith |
string | нет | "" |
Крайние случаи. Некорректный или небезопасный шаблон делает оператор no-op
(возвращает вход). На группы захвата можно ссылаться в replaceWith через $1,
$2, …
Пример. "a-b" с regex="-", replaceWith="_" → "a_b"
replaceAll
Вид: трансформер · Обработка значения: per-item
Заменяет каждое вхождение литеральной искомой строки (без regex).
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
search |
string | да | — |
replaceWith |
string | нет | "" |
Крайние случаи. Пустой search — no-op.
Пример. "hello" с search="l", replaceWith="r" → "herro"
regexReplace
Вид: трансформер · Обработка значения: per-item
Заменяет совпадения regex с настраиваемыми флагами.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
regex |
string (regex) | да | — |
replaceWith |
string | нет | "" |
flags |
string | нет | g |
Пример. "abc123def456" с regex="\\d+", replaceWith="X" → "abcXdefX"
padStart
Вид: трансформер · Обработка значения: per-item
Дополняет начало строки до целевой длины.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
length |
number | да | 0 |
char |
string | нет | пробел |
Пример. "7" с length=3, char="0" → "007"
padEnd
Вид: трансформер · Обработка значения: per-item
Дополняет конец строки до целевой длины.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
length |
number | да | 0 |
char |
string | нет | пробел |
Пример. "hi" с length=5, char="." → "hi..."
stringReverse
Вид: трансформер · Обработка значения: per-item
Разворачивает символы строки.
Пример. "abc" → "cba"
stringCount
Вид: трансформер · Обработка значения: per-item
Считает вхождения литеральной искомой строки. Результат — число.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
search |
string | да | — |
Крайние случаи. Пустой search возвращает 0.
Пример. "banana" с search="an" → 2
escapeHTML
Вид: трансформер · Обработка значения: per-item
Экранирует &, <, >, ", ' как HTML-сущности.
Пример. "<a>&" → "<a>&"
unescapeHTML
Вид: трансформер · Обработка значения: per-item
Декодирует &, <, >, ", ' обратно в символы.
Пример. "<a>" → "<a>"
StripChars
Вид: трансформер · Обработка значения: per-item
Обрезает заданные символы с обоих концов строки. Вхождения в середине сохраняются.
| Аргумент | Тип | Обязателен | По умолчанию |
|---|---|---|---|
chars |
string | да | — |
Крайние случаи. Пустой chars — no-op. Строка, целиком состоящая из
обрезаемых символов, становится "".
Пример. "<<a<b>>" с chars="<>" → "a<b"