jz-toolkit

🚀 一个轻量级、功能丰富的 JavaScript/TypeScript 工具库。

🆕 最近更新

v1.2.0

• 新增 color 模块 - 颜色工具函数集合
• 新增 generateColors() - 生成指定数量的随机十六进制颜色
• 新增 generateRandomColor() - 生成单个随机十六进制颜色
• 新增 generateHarmoniousColors() - 生成基于HSL的和谐色彩组合
• 新增 generateGradientColors() - 生成渐变色彩组合
• 新增 hexToRgb() - 将十六进制颜色转换为RGB格式
• 新增 rgbToHex() - 将RGB颜色转换为十六进制格式
• 新增 hslToHex() - 将HSL颜色转换为十六进制格式
• 新增 hexToHsl() - 将十六进制颜色转换为HSL格式
• 新增颜色验证函数：isValidHex(), isValidRgb(), isValidHsl()

import { generateColors, hexToRgb, generateHarmoniousColors } from "jz-toolkit";

// 生成8个随机颜色
const colors = generateColors(8);
// 返回: ['#FF5733', '#33FF57', '#5733FF', ...]

// 十六进制转RGB
const rgb = hexToRgb("#FF5733");
// 返回: { r: 255, g: 87, b: 51 }

// 生成和谐色彩组合
const harmoniousColors = generateHarmoniousColors(120, 6, 70, 50);
// 返回: ['#26D926', '#26D9D9', '#2626D9', ...]

v1.1.9

• 新增 renderTemplate() - 字符串模板替换函数，支持灵活的变量替换

import { renderTemplate } from "jz-toolkit";

const result = renderTemplate(
  { name: "张三", money: 100.5 },
  "你好, {{name}}! 你的余额是 {{money}} 元。",
);
// 返回: "你好, 张三! 你的余额是 100.50 元。"

v1.1.8

• 新增 toThousandsIntl() - 国际化数字千分位格式化函数，支持多地区格式
• 新增 toThousands() - 常规数字千分位格式化函数

import { toThousandsIntl, toThousands } from "jz-toolkit";

toThousandsIntl(1234567.89, "zh-CN"); // '1,234,567.89'
toThousandsIntl(1234567.89, "de-DE"); // '1.234.567,89'
toThousands(1234567.89); // '1,234,567.89'

特点

✨ 类型安全 - 使用 TypeScript 编写，提供完整的类型定义

📦 模块化 - 支持按需导入，减少打包体积

⚡ 高性能 - 精心优化的实现

🔧 易于扩展 - 清晰的项目结构，易于添加新功能

📚 良好文档 - 每个函数都有详细的文档和示例

安装

  npm i jz-toolkit

官方文档地址 - 更多Api在文档查阅

http://172.81.245.148:8098/api/utils.html

快速开始

聊天群

完整导入

import * as _ from "jz-toolkit";

_.chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
_.capitalize("hello"); // 'Hello'

按需导入

import { chunk, capitalize } from "jz-toolkit";

chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
capitalize("hello"); // 'Hello'

模块导入

import * as array from "jz-toolkit/array";
import * as object from "jz-toolkit/object";
import * as string from "jz-toolkit/string";

array.chunk([1, 2, 3, 4], 2);
object.pick({ a: 1, b: 2 }, ["a"]);
string.capitalize("world");

开发

安装依赖

npm install

构建

npm run build

开发模式（监视文件变化）

npm run dev

运行测试

npm test

查看测试覆盖率

npm run test:coverage

代码格式化

npm run format

Linting

npm run lint

项目结构

src/
├── index.ts           # 主入口
├── types/             # 类型定义
├── array/             # 数组模块
├── object/            # 对象模块
├── string/            # 字符串模块
└── utility/           # 工具函数模块

许可证

MIT

贡献

欢迎贡献！请提交 PR 或 Issue。