@front-cmdt/utils

Библиотека полезных утилит для фронтенд-разработки.

Установка

yarn add @front-cmdt/utils
# или
npm install @front-cmdt/utils

Утилиты

errorCatch

Обработка ошибок из ответов API. Возвращает текст ошибки из переданной мапы сообщений или из самой ошибки.

Сигнатура:

errorCatch(error: any, options?: ErrorCatchOptions): string | string[]

ErrorCatchOptions:

| Поле | Тип | По умолчанию | Описание | | -------------- | ------------------------- | ------------ | --------------------------------------------------------------- | | errorTextMap | Record<string, string> | — | Мапа «ключ из ответа → читаемый текст» | | mode | 'first' | 'all' | 'first' | Вернуть первое сообщение (string) или все (string[]) |

Поддерживает ошибки с вложенной структурой error.response.data.message (в т.ч. когда message — массив строк).

Примеры:

import { errorCatch } from '@front-cmdt/utils/error-catch'

const ERROR_MAP = {
  'learning must be an object': 'Обучение должно быть объектом',
}

// Первое сообщение с маппингом
try {
  // ...
} catch (error: any) {
  console.log(errorCatch(error, { errorTextMap: ERROR_MAP }))
  // 'Обучение должно быть объектом'
}

// Все сообщения
try {
  // ...
} catch (error: any) {
  console.log(errorCatch(error, { mode: 'all' }))
  // ['learning must be an object', 'name must be a string']
}

// Без опций — вернёт первое сообщение из ответа или error.message
try {
  // ...
} catch (error: any) {
  console.log(errorCatch(error))
  // 'Unauthorized access'
}

getName (работа с ФИО)

Набор функций для разбора, валидации и форматирования ФИО. Входные данные: объект { firstName, lastName, middleName }, строка «Фамилия Имя Отчество» или массив строк.

numberSeparator

Форматирование числа с пробелами в качестве разделителя тысяч. Поддерживает целые числа и числа с дробной частью.

Примеры:

• numberSeparator(1000) → '1 000'
• numberSeparator(1000000) → '1 000 000'
• numberSeparator(-1000000) → '-1 000 000'

formatPhone

Форматирование российского телефонного номера по одному из заданных шаблонов.

Параметры: phone — строка или число (цифры номера), variant — желаемый формат.

Варианты формата:

| variant | Пример результата | | -------------------- | ----------------- | | '+79999999999' | +79155555555 | | '79999999999' | 79155555555 | | '+7(999)999-99-99' | +7(915)555-55-55 | | '89999999999' | 89155555555 | | '+7 999 999 99-99' | +7 915 555 55-55 |

Номер нормализуется: остаются только цифры, код страны 7/8 при необходимости убирается. Ожидается не менее 10 цифр; иначе возвращается undefined.

ms

Преобразование строки с длительностью в миллисекунды. Принимает строку вида «число + единица времени» и возвращает число миллисекунд.

Параметры: str — строка (например, '2 days', '1h', '30s').

Поддерживаемые единицы: ms (миллисекунды), s (секунды), m (минуты), h (часы), d (дни), w (недели), mo (месяцы), y (годы). Допускаются полные названия и сокращения (seconds, secs, day, days и т.д.).

Примеры:

• ms('2 days') → 172800000
• ms('1h') → 3600000
• ms('30s') → 30000
• ms('1.5 min') → 90000

При невалидной строке или неизвестной единице возвращается NaN. Пустая строка, строка длиннее 100 символов или нестрока приводят к выбросу ошибки.

log

Функция для красивого логирования в консоль с цветовым оформлением и эмодзи. Предназначена для логирования HTTP-запросов, ответов и ошибок.

Параметры:

• name — название лога (строка)
• data — данные для логирования (любой тип)
• type — тип лога: 'request' (запрос), 'response' (ответ), 'catch' (ошибка)
• payload? — дополнительные данные (опционально)
• isServer? — флаг серверного логирования, убирает декоративные элементы (опционально)
• isDisabled? — отключает логирование полностью, если true (опционально)

Особенности:

• Использует стилизованный вывод в консоль с цветами и эмодзи
• Если data не передан (undefined/null), логирование не выполняется
• Для клиентского логирования (isServer не установлен) добавляет декоративные разделители
• Каждый тип лога имеет свой цвет: request (cyan), response (green), catch (red)

Примеры:

// Логирование запроса
log({
  name: 'GET /api/users',
  data: { userId: 123 },
  type: 'request',
  payload: { headers: { Authorization: 'Bearer token' } }
})

// Логирование ответа
log({
  name: 'GET /api/users',
  data: { users: [...] },
  type: 'response'
})

// Логирование ошибки
log({
  name: 'GET /api/users',
  data: error,
  type: 'catch'
})

// Серверное логирование (без декоративных элементов)
log({
  name: 'Server log',
  data: { message: 'Server started' },
  type: 'response',
  isServer: true
})