ДокументацияОператоры маппера6. Трансформеры конвертации и кодирования (Conversion & encoding)

Трансформеры конвертации и кодирования (Conversion & encoding)

Помощники для приведения типов, кодирования и структурированных форматов.

base64Encode

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

Кодирует строковые значения в base64 (безопасно для UTF-8).

Пример. "abc""YWJj"

base64Decode

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

Декодирует строковые значения base64 в UTF-8. Некорректный вход возвращается без изменений.

Пример. "YWJj""abc"

encodeURL

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

Процентно-кодирует строковые значения.

Пример. "a b&c""a%20b%26c"

decodeURL

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

Декодирует процентно-кодированные строковые значения. Некорректный вход остаётся без изменений.

Пример. "a%20b""a b"

toString

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

Приводит значение к строке.

Пример. 42"42"

toNumber

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

Приводит значение к числу. Нечисловой вход остаётся без изменений.

Пример. "42"42 · "abc""abc"

toBoolean

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

Приводит к булеву. Строки "false", "0" и "" — это false; любая другая непустая строка — true.

Пример. "false"false · "yes"true

toArray

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

Оборачивает не-массивное значение в массив из одного элемента (массив возвращается как есть).

Пример. "x"["x"]

toJSON

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

Сериализует значение в JSON. Строки тоже заключаются в кавычки.

Пример. {"a":1}'{"a":1}' · "x"'"x"'

urlParse

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

Разбирает URL на scheme, host, path, query, fragment. Строка, не являющаяся URL, проходит насквозь.

Пример. "https://ex.com/p?q=1#f"{"scheme":"https","host":"ex.com","path":"/p","query":"q=1","fragment":"f"}

parseCSV

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

Разбирает CSV-текст в строки. Обрабатываются ячейки в кавычках (экранирование "") и окончания строк \r\n/\n; строка из пустых ячеек (,,) — это данные, но пустая строка пропускается.

Пример. '"a,1",b\nc,d'[["a,1","b"],["c","d"]]

toCSV

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

Сериализует массив (объектов или массивов-строк) в CSV. Для объектов ключи первого элемента образуют строку заголовка; ячейки с запятыми/кавычками/переводами строк заключаются в кавычки.

Пример. [{"a":1,"b":2},{"a":3,"b":4}]"a,b\n1,2\n3,4"

parseXML

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

Плоское извлечение тегов по принципу «побеждает последний» — это не полноценный XML-парсер. Вложенные/повторяющиеся теги не моделируются; каждый <tag>text</tag> становится одним ключом.

Пример. "<a>1</a><b>2</b>"{"a":"1","b":"2"}

toMarkdownTable

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

Отображает массив объектов как Markdown-таблицу (ключи первого элемента — это колонки).

Пример. [{"name":"h1","ip":"10.0.0.1"}]

| name | ip |
| --- | --- |
| h1 | 10.0.0.1 |