带immediate参数的防抖函数支持两种模式：immediate为true时首次触发立即执行、重复触发被忽略、冷却后重置；为false时始终等待空闲后执行。
简易防抖函数支持 immediate 参数，关键在于区分“首次触发立即执行、后续空闲期才执行”和“始终等待空闲后执行”两种模式。核心逻辑是：用一个标志记录是否已执行过，配合定时器控制重置与调用时机。
理解 immediate 的行为含义
immediate: true 表示第一次调用函数时立刻执行，之后在等待时间内再次触发则不执行；等等待时间结束后，下一次触发才重新进入“立即执行”流程（即“首次触发即执行，重复触发被忽略，冷却后重置”）。
immediate: false（默认）则是常规防抖：无论第几次触发，都只在最后一次触发后的延迟时间结束后执行。
实现带 immediate 的防抖函数
以下是简洁可靠的实现，保留可读性与实用性：
function debounce(func, wait, immediate = false) {
let timeout = null;
return function executedFunction() {
const later = () => {
timeout = null;
if (!immediate) func.apply(this, arguments);
};
const shouldCallNow = immediate && !timeout;
if (shouldCallNow) func.apply(this, arguments);
clearTimeout(timeout);
timeout = setTimeout(later, wait);
};
}
说明要点：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 用
timeout === null判断是否处于“初始态”或“冷却结束态”，这是识别“首次触发”的依据 -
shouldCallNow在immediate为真且尚未启动定时器时成立，此时立即执行 - 每次调用都先清掉旧定时器，再设新定时器，确保只有最后一次触发能走到
later分支 -
func.apply(this, arguments)保证 this 和参数正确传递（ES6 可用...args替代）
使用示例对比
假设用于搜索框输入事件：
立即学习“Java免费学习笔记（深入）”；
-
debounce(search, 300, false)：用户打完字停顿 300ms 后才发起请求 -
debounce(search, 300, true)：用户一输入就发请求（比如查热门关键词），之后连续输入不发，直到停顿 300ms 后，下一次输入又会立刻触发
注意事项
该实现不自动取消已执行的异步操作（如正在发送的请求），如需取消，请配合 AbortController 或返回取消函数；另外，immediate 模式下无法通过 clearTimeout 中断已立即执行的调用——它只影响后续延迟执行分支。
