r-utils

一个现代化的 TypeScript 工具函数库，提供了常用的字符串、数组、对象和日期处理函数。

安装

npm install r-utils

功能特性

• 完整的 TypeScript 类型支持
• 支持 ESM 和 CommonJS 模块规范
• 包含字符串、数组、对象和日期处理等常用工具函数
• 代码轻量化，可按需引入

使用示例

import { capitalize, unique, deepClone, formatDate } from 'r-utils';

// 字符串处理
console.log(capitalize('hello')); // 'Hello'

// 数组操作
console.log(unique([1, 1, 2, 3])); // [1, 2, 3]

// 对象处理
const obj = { a: 1, b: { c: 2 } };
const cloned = deepClone(obj);

// 日期格式化
console.log(formatDate(new Date(), 'YYYY-MM-DD')); // '2024-03-20'

API 文档

字符串工具

• capitalize(str: string): string - 首字母大写
• camelToKebab(str: string): string - 驼峰命名转连字符命名
• kebabToCamel(str: string): string - 连字符命名转驼峰命名
• truncate(str: string, length: number): string - 截取字符串并添加省略号

数组工具

• unique<T>(arr: T[]): T[] - 数组去重
• groupBy<T>(arr: T[], key: keyof T): Record<string, T[]> - 数组分组
• flatten<T>(arr: (T | T[])[]): T[] - 数组扁平化
• random<T>(arr: T[]): T - 获取数组中的随机元素

对象工具

• deepClone<T>(obj: T): T - 深拷贝对象
• get(obj: any, path: string | string[], defaultValue?: any): any - 获取对象指定路径的值
• merge<T extends object>(target: T, ...sources: Partial<T>[]): T - 合并对象
• removeEmpty<T extends object>(obj: T): Partial<T> - 移除对象中值为 null 或 undefined 的属性

日期工具

• formatDate(date: Date | number, format?: string): string - 格式化日期
• getRelativeTime(date: Date | number): string - 获取相对时间描述
• addDays(date: Date, days: number): Date - 添加天数
• isSameDay(date1: Date, date2: Date): boolean - 判断是否为同一天

开源协议

MIT