Разделы документации

Документация›Операторы маппера›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 |