从 debounce 到 deepClone——你的 JS 瑞士军刀。
你也经历过那种感觉吧:当你深入一个项目,突然需要对某个函数进行 debounce 处理、限制某个滚动事件,或者安全地访问一个嵌套对象。
没错,我也是。
所以,与其每次都从头开始编写这些实用工具,不如整理一下这个包含 25 个可复用的 JavaScript 函数的小集合,我几乎会把它们复制粘贴到每个项目中。
它们简短、精炼,而且非常实用。嘿,如果你正在用 React、Vue、Angular、Vanilla JS 构建任何东西,或者甚至用记事本(别觉得丢人)抄 HTML(这可不是闹着玩的),这些函数都能帮你节省时间。
我们开始吧。
1. Debounce
function debounce(fn, delay = 300) {
let timeout;
return (...args) => {
clearTimeout(timeout);
timeout = setTimeout(() => fn(...args), delay);
};
}
非常适合搜索输入和调整大小事件,给你的函数留出一些喘息的空间。
2. 节流阀
function throttle(fn, limit = 300) {
let inThrottle; return (...args) => {
if (!inThrottle) {
fn(...args);
inThrottle = true;
setTimeout(() => (inThrottle = false), limit);
}
};
}
因为每次滚动像素触发 = 浏览器崩溃。
3. 深度克隆
function deepClone(obj) {
return JSON.parse(JSON.stringify(obj));
}
它并不完美(函数可能会丢失),但 90% 的情况下都能正常工作。
4. 复制到剪贴板
像老板一样粘贴,适用于现代浏览器。
function copyToClipboard(text) {
navigator.clipboard.writeText(text).catch(console.error);
}
5. Sleep
用于延迟动画或模拟异步加载。
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
6. Clamp
控制值——例如滚动位置或输入限制。
function clamp(value, min, max) {
return Math.min(Math.max(value, min), max);
}
7. Object
因为 typeof null === 'object' 是 JavaScript 版的恶意代码。
function isObject(val) {
return val && typeof val === 'object' && !Array.isArray(val);
}
8. Empty
当 if (obj) 无法满足需求时。
function isEmpty(obj) {
return Object.keys(obj).length === 0;
}
9. UUID 生成器
即时唯一 ID——无需 npm i uuid。
function uuid() {
return crypto.randomUUID();
}
10. Once
有时候,一次就够了。想想:事件监听器、API 调用、烟火表演。
function once(fn) {
let called = false; return (...args) => {
if (!called) {
called = true; fn(...args);
}
};
}
11. 获取查询参数
是的,?page=2&sort=desc 需要解码。
function getQueryParams() {
return Object.fromEntries(new URLSearchParams(location.search));
}
12. 范围生成器
因为 for 循环现在已经过时了。
function range(start, end, step = 1) {
return Array.from({ length: (end - start) / step + 1 }, (_, i) => start + i * step);
}
13. 移除重复项
不再需要复杂的过滤操作。让 Set 自行处理。
function unique(arr) {
return [...new Set(arr)];
}
14. 安全访问 (get)
深度访问,不会导致应用崩溃。类似 Lodash 的 get(),但更精简。
function get(obj, path, fallback = undefined) {
return path.split('.').reduce((acc, key) => acc?.[key], obj) ?? fallback;
}
15. 分组
根据公共属性对项目列表进行分组。即时分析的魔法。
function groupBy(arr, key) {
return arr.reduce((acc, obj) => {
const val = obj[key];
acc[val] = acc[val] || [];
acc[val].push(obj);
return acc;
}, {});
}
16. 移除空值
清除 null、undefined、0 和 "" 等虚假值。
function compact(arr) {
return arr.filter(Boolean);
}
17. Time Ago
即时“5 分钟前发布”的魔法。
function timeAgo(date) {
const seconds = Math.floor((Date.now() - new Date(date)) / 1000);
const units = [
[60, 'second'],
[60, 'minute'],
[24, 'hour'],
[7, 'day'],
[4.3, 'week'],
[12, 'month'],
[Number.POSITIVE_INFINITY, 'year']
];
let i = 0;
while (seconds >= units[i][0]) {
seconds /= units[i][0];
i++;
}
const value = Math.floor(seconds);
const label = units[i][1];
return `${value} ${label}${value !== 1 ? 's' : ''} ago`;
}
18. isEqual(浅)
非常适合快速比较(但不适用于大型嵌套对象)。
function isEqual(a, b) {
return JSON.stringify(a) === JSON.stringify(b);
}
19. 随机排序
给你的 UI 或测验应用增添一点混乱。
function shuffle(arr) {
return arr.sort(() => Math.random() - 0.5);
}
20. 格式化货币
因为 $123456.789 看起来应该写成 $123,456.79 更好。
function formatCurrency(amount, locale = 'en-US', currency = 'USD') {
return new Intl.NumberFormat(locale, {
style: 'currency',
currency, }).format(amount);
}
21. 扁平化数组
将 [1, [2, [3]]] 转换为 [1, 2, 3] —— 递归,谁用得着?
function flatten(arr) {
return arr.flat(Infinity);
}
22. isBrowser
用于服务器端渲染设置并避免出现 window is not definition 错误。
function isBrowser() {
return typeof window !== 'undefined';
}
23. 大写
将 hello 转换为 Hello,就像一个普通的字符串一样。
function capitalize(str) {
return str.charAt(0).toUpperCase() + str.slice(1);
}
24. 分块数组
将大数组拆分成易于理解的小块。
function chunk(arr, size) {
return Array.from({ length: Math.ceil(arr.length / size) }, (_, i) =>
arr.slice(i * size, i * size + size)
);
}
25. 深度合并
类似 Object.assign,但更偏向递归。
function mergeDeep(target, source) {
for (const key in source) {
if (isObject(source[key])) {
if (!target[key]) Object.assign(target, { [key]: {} });
mergeDeep(target[key], source[key]);
} else {
Object.assign(target, { [key]: source[key] });
}
} return target;
}
总结
以上就是我今天想与你分享的25 个我几乎离不开的 JavaScript 实用函数。
复制粘贴它们,修改它们,如果需要的话,把它们刻在你的键盘上。
阅读原文:https://mp.weixin.qq.com/s/iLr1on2RGHFK79C3Axr7MQ
该文章在 2025/5/19 12:26:39 编辑过