前端工具库 (Frontend Utils)

一个轻量级的前端工具库，包含常用的JavaScript工具函数。

安装

npm install tudou-frontend-utilities

或者使用CDN引入：

<script src="https://unpkg.com/tudou-frontend-utilities/dist/utils.min.js"></script>

使用方法

ES6 模块导入

// 导入整个工具库
import Utils from 'tudou-frontend-utilities';

// 或者按需导入特定函数
import { debounce, throttle } from 'tudou-frontend-utilities';

// 使用防抖函数
const debouncedFunc = Utils.debounce(myFunction, 300);

// 使用节流函数
const throttledFunc = Utils.throttle(scrollHandler, 100);

浏览器直接引入

<script src="node_modules/tudou-frontend-utilities/dist/utils.min.js"></script>
<script>
  // 使用工具函数
  const debouncedFunc = FrontendUtils.debounce(myFunction, 300);
</script>

API 文档

debounce(func, delay)

防抖函数，在指定时间间隔内只执行最后一次调用。

const debouncedSearch = debounce((query) => {
  console.log('搜索:', query);
}, 300);

throttle(func, delay)

节流函数，在指定时间间隔内最多执行一次。

const throttledScroll = throttle(() => {
  console.log('滚动事件触发');
}, 100);

deepClone(obj)

深拷贝函数，复制对象或数组。

const originalObj = { a: 1, b: { c: 2 } };
const clonedObj = deepClone(originalObj);

isValidEmail(email)

检查邮箱格式是否有效。

console.log(isValidEmail('[email protected]')); // true
console.log(isValidEmail('invalid-email')); // false

formatNumber(num)

格式化数字为千分位显示。

console.log(formatNumber(1234567)); // '1,234,567'

getUrlParams(url)

获取URL参数。

const params = getUrlParams(window.location.href);
console.log(params.id); // 获取URL中的id参数

generateId(len)

生成指定长度的唯一ID。

console.log(generateId()); // 'AbC1dE2f' (默认8位)
console.log(generateId(12)); // 'XyZ3aBcD4eF5' (12位)

开发

# 克隆项目
git clone <your-repo-url>

# 安装依赖
npm install

# 构建项目
npm run build

# 运行测试
npm test

许可证

MIT