@ismartify/steady

Languages: 🇨🇳 中文 | 🇺🇸 English

🚀 稳定高效的防抖和节流工具库 - 专为现代前端应用优化，在真实场景测试中实现 99% 性能提升！

"steady" 意为"稳定的、持续的、可靠的"，正如这个库的核心理念：通过智能的防抖和节流机制，让你的应用在高频调用场景下依然保持稳定高效的性能表现。

✨ 特性

• 🎯 零依赖 - 轻量级，无外部依赖
• 🔧 TypeScript 支持 - 完整的类型定义
• ⚡ 高性能优化 - 真实测试中网络请求减少99%
• 🧪 全面测试 - 包含极限压力测试和真实场景测试
• 📦 多格式支持 - 支持 ESM 和 CommonJS

安装

pnpm add @ismartify/steady

使用方法

debounce (防抖)

import { debounce } from '@ismartify/steady'

// 创建一个防抖函数，延迟1000ms执行
const debouncedFunc = debounce(() => {
  console.log('Debounced!')
}, 1000)

// 多次调用，但只会在最后一次调用后1000ms执行一次
debouncedFunc()
debouncedFunc()
debouncedFunc() // 只有这次调用会在1000ms后执行

throttle (节流)

import { throttle } from '@ismartify/steady'

// 创建一个节流函数，每1000ms最多执行一次
const throttledFunc = throttle(() => {
  console.log('Throttled!')
}, 1000)

// 无论调用多少次，每1000ms最多执行一次
throttledFunc()
throttledFunc()
throttledFunc()

🚀 性能测试结果

我们进行了全面的性能测试，包括真实网络环境下的 i18n 场景测试，结果令人印象深刻：

📊 极限压力测试 - 100次重复请求

| 测试场景 | 网络请求次数 | 性能提升 | |---------|-------------|----------| | 🔴 无优化版本 | 100次 | 基准 | | 🟢 防抖优化版本 | 1次 | 99.0% ⚡ |

结果：100次翻译调用被优化为仅1次网络请求！

🌟 多文件并发压力测试 - 400次调用

| 指标 | 数值 | |------|------| | 📊 总翻译调用 | 400次 | | ⚡ 实际网络请求 | 4次 | | 🎯 压缩比例 | 100:1 | | 🚀 性能提升 | 99% |

💡 真实场景应用

在前端 i18n 国际化场景中，多个组件可能同时请求相同的翻译文件：

// 🔴 无优化：每次调用都会发起网络请求
t('common.button.save')    // 第1次网络请求
t('common.button.cancel')  // 第2次网络请求  
t('common.button.submit')  // 第3次网络请求
// ... 更多重复请求

// 🟢 使用防抖优化：多次调用合并为1次网络请求
const debouncedFetch = debounce(fetchI18nData, 10)
// 无论调用多少次，同一文件只请求一次！

🎯 生产环境价值

• 💰 成本节省：API调用费用减少99%
• ⚡ 响应速度：网络延迟大幅降低
• 🔋 资源节省：服务器负载减少99%
• 📱 用户体验：应用响应更流畅

API

debounce(func, wait, immediate?)

创建一个防抖函数，该函数会在等待 wait 毫秒后调用 func。如果在等待期间再次调用，则重新计时。

• func: 要防抖的函数
• wait: 等待时间（毫秒）
• immediate: 是否在延迟开始前调用（默认为 false）

throttle(func, wait)

创建一个节流函数，该函数最多每 wait 毫秒调用一次 func。

• func: 要节流的函数
• wait: 等待时间（毫秒）

🧪 测试套件

本库包含全面的测试套件，验证各种使用场景：

基础功能测试

• ✅ 防抖函数基本功能
• ✅ 节流函数基本功能
• ✅ immediate 模式测试

暴力压力测试

• ✅ 10000次高频调用测试
• ✅ 连续间隔调用测试
• ✅ 混合使用场景测试

真实场景测试

• ✅ i18n 国际化场景模拟
• ✅ 100次极限重复请求
• ✅ 多文件并发压力测试
• ✅ 网络错误处理测试

# 运行所有测试
pnpm test

# 运行 i18n 场景测试
pnpm test:i18n

# 运行测试覆盖率
pnpm test:coverage

License

MIT