@alfalab/utils

中文文档
1.22.0发布于 2026/10/21MITTypeScriptESM + CJS近 30 天下载 1.7万

common utils

原始使用文档
文档目录19 节
  1. 📦 Установка
  2. 🔨 Использование
  3. Состав
  4. crop-account-number
  5. format-account
  6. format-amount
  7. format-file-size
  8. format-phone
  9. get-all-currency-codes
  10. get-countries
  11. get-currency-symbol
  12. is-overflown
  13. is-valid-card-number
  14. pluralize
  15. seconds-to-time
  16. split-amount
  17. is-valid-email
  18. keyboard-switcher
  19. transform-data

@alfalab/utils

Набор частоиспользуемых хелперов

📦 Установка

yarn add @alfalab/utils

🔨 Использование

import { cropAccountNumber } from '@alfalab/utils';

Состав

crop-account-number

  • cropAccountNumber — обрезает номер счета до 4 последних цифр.
    40817810210210285256 -> ··5256

format-account

  • formatAccount — Возвращает отформатированное значение счёта, разделенное пробелами.
    XXXXX XXX X XXXX XXXXXXX

format-amount

  • formatAmount — Форматирует значение суммы согласно гайдлайну

format-file-size

  • formatFileSize — Возвращает отформатированное значение размера файла.
    100000 -> 97.66 KB

format-phone

Набор для работы с номерами телефонов.

  • phoneNumber.format — Форматирует номер телефона. 71112223344 —> +7 111 222-33-44
  • phoneNumber.getRaw — Удаляет форматирование из номера.
  • phoneNumber.mask — Маскирует номер телефона, оставляя код и последние 4 цифры. +7 ··· ··· 33-44

get-all-currency-codes

  • getAllCurrencyCodes — Возвращает список валют

get-countries

утилиты для работы со странами:

  • getCountries — вернет массив объектов Country;
  • getCountriesMap — вернет объект, где ключ объекта - код страны (iso2), значение - объект Country;

get-currency-symbol

  • getCurrencySymbol — Возвращает знак валюты по ISO коду.

is-overflown

  • isOverflown — возвращает true, если html-элемент переполнен. Необходимо в случаях когда надо определить, есть ли у элемента скроллбар или текст в элементе обрезался (text-overflow).

is-valid-card-number

  • isValidCardNumber — принимает номер карты и возвращает true, если номер карты валидный по алгоритму Луна.

pluralize

  • pluralize — Возвращает форму множественного числа указанного слова.
    pluralize(2, 'карту', 'карты', 'карт') — карты

seconds-to-time

— secondsToTime — Приводит секунды к формату hh:mm:ss и возвращает объект с ними.

split-amount

  • splitAmount — Дробит мажорную часть суммы на части по указанному символу.
    splitAmount('10000000', 3, ' ') - '10 000 000'

is-valid-email

  • isValidEmail — Возвращает true для валидного email, иначе false
    isValidEmail('[email protected]') - true

keyboard-switcher

  • formatToRussian — Приводит все символы к русской раскладки.
  • switchToKeyboard — Все символы приводятся к одной раскладки.
  • keyboardSwitcher — Конвертирует символы из одной раскладки в другую.
  • isKeyboardLayout — Проверяет строку на совпадение с раскладкой клавиатуры.

transform-data

  • transformData — Форматирует измененный объектом на основе конфига.
    transformData({ phones: ['+123','+234'], meta: 'info' }, { replace: { phones[*]: (value)=> value.slice(1) }, filter: ['meta'] }) -> { phones: ['123','234'] }

版本与发布记录

@alfalab/utils 共发布 52 个版本,首次发布于 2020/07/02;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.22.0latest2026/10/2117 天前
1.21.02026/08/112 个月前
1.20.02026/03/197 个月前
1.18.22026/03/028 个月前
1.18.12025/06/301.4 年前
1.18.02025/02/181.7 年前

其他发布通道:next → 1.17.0-next.2。

关于 @alfalab/utils 的常见问题

@alfalab/utils 是什么?

common utils

如何安装 @alfalab/utils?

在项目目录运行 npm install @alfalab/utils,或使用 pnpm add / yarn add / bun add。

@alfalab/utils 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@alfalab/utils 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@alfalab/utils 可以商用吗?

@alfalab/utils 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@alfalab/utils 的下载量有多少?

根据 npm 官方下载统计,@alfalab/utils 在 2026/10/06 – 2026/11/04 这 30 天内被下载 17,163 次,日均约 572 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@alfalab/utils 还在维护吗?

最新版本 1.22.0 发布于 2026/10/21(17 天前);至今共发布 52 个版本,其中过去 12 个月发布了 4 个;首次发布于 2020/07/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。