Строковые трансформеры (String)

Операторы, перестраивающие текст. Строковые операторы используют контракт per-item (кроме split, превращающего одну строку в массив, и join, ориентированного на массив): скалярная строка преобразуется напрямую, а над массивом преобразуется каждый строковый элемент, тогда как нестроковые элементы проходят насквозь.

Вид: трансформер · Обработка значения: whole-value

Удаляет HTML-разметку и декодирует распространённые сущности в читаемый обычный текст.

Поведение. Удаляет блоки <style>/<script>, преобразует <br> в перевод строки, а </p> — в пустую строку, отбрасывает все прочие теги, декодирует  , &, <, > и схлопывает лишние пробелы.

Крайние случаи. Нестроковый вход проходит насквозь без изменений.

Пример. "<p>Hi</p>" → "Hi"

Вид: трансформер · Обработка значения: per-item · Синоним: mapper_trim

Удаляет начальные и конечные пробелы.

Крайние случаи. Над массивом обрезает строковые элементы и оставляет нестроковые нетронутыми.

Пример. " x " → "x" · [" a ", 1, " b "] → ["a", 1, "b"]

Вид: трансформер · Обработка значения: per-item

Удаляет только начальные пробелы.

Пример. " hello " → "hello "

Вид: трансформер · Обработка значения: per-item

Удаляет только конечные пробелы.

Пример. " hello " → " hello"

Вид: трансформер · Обработка значения: per-item · Синоним: mapper_toLowerCase

Приводит строковые значения к нижнему регистру.

Пример. "AbC" → "abc"

Вид: трансформер · Обработка значения: per-item · Синоним: mapper_toUpperCase

Приводит строковые значения к верхнему регистру.

Пример. "AbC" → "ABC"

Вид: трансформер · Обработка значения: per-item

Извлекает подстроку по начальному индексу и опциональному конечному индексу.

Поведение. Использует String.substring(start, end); end не включается.

Пример. "abcdef" с start=1, end=4 → "bcd"

Вид: трансформер · Обработка значения: whole-value

Разбивает строку в массив по разделителю.

Крайние случаи. Нестроковый вход проходит насквозь без изменений.

Пример. "a|b" с delimiter="|" → ["a", "b"]

Вид: трансформер · Обработка значения: array

Соединяет элементы массива в строку с разделителем (каждый элемент приводится к тексту; null/undefined становятся пустой строкой).

Пример. ["a", "b"] с separator="-" → "a-b"

Вид: трансформер · Обработка значения: per-item

Заменяет все совпадения регулярного выражения (применяется с глобальным флагом).

Крайние случаи. Некорректный или небезопасный шаблон делает оператор no-op (возвращает вход). На группы захвата можно ссылаться в replaceWith через $1, $2, …

Пример. "a-b" с regex="-", replaceWith="_" → "a_b"

Вид: трансформер · Обработка значения: per-item

Заменяет каждое вхождение литеральной искомой строки (без regex).

Крайние случаи. Пустой search — no-op.

Пример. "hello" с search="l", replaceWith="r" → "herro"

Вид: трансформер · Обработка значения: per-item

Заменяет совпадения regex с настраиваемыми флагами.

Пример. "abc123def456" с regex="\\d+", replaceWith="X" → "abcXdefX"

Вид: трансформер · Обработка значения: per-item

Дополняет начало строки до целевой длины.

Пример. "7" с length=3, char="0" → "007"

Вид: трансформер · Обработка значения: per-item

Дополняет конец строки до целевой длины.

Пример. "hi" с length=5, char="." → "hi..."

Вид: трансформер · Обработка значения: per-item

Разворачивает символы строки.

Пример. "abc" → "cba"

Вид: трансформер · Обработка значения: per-item

Считает вхождения литеральной искомой строки. Результат — число.

Крайние случаи. Пустой search возвращает 0.

Пример. "banana" с search="an" → 2

Вид: трансформер · Обработка значения: per-item

Экранирует &, <, >, ", ' как HTML-сущности.

Пример. "<a>&" → "<a>&"

Вид: трансформер · Обработка значения: per-item

Декодирует &, <, >, ", ' обратно в символы.

Пример. "<a>" → "<a>"

Вид: трансформер · Обработка значения: per-item

Обрезает заданные символы с обоих концов строки. Вхождения в середине сохраняются.

Крайние случаи. Пустой chars — no-op. Строка, целиком состоящая из обрезаемых символов, становится "".

Пример. "<<a<b>>" с chars="<>" → "a<b"

---