防抖函数需支持立即执行（flush）和彻底取消（cancel）：cancel(true)或flush()清空定时器并立即执行最新参数；cancel(false)或cancel()仅清除定时器且丢弃状态；实现中须缓存this与args，flush时复用并清空缓存。
防抖函数的核心逻辑：延迟执行与可取消性
防抖（debounce）的本质是“等用户操作停顿后再执行”，但真实场景中常需中途干预——比如输入框搜索，用户还没输完就点了“清空”按钮，这时应立即触发最后一次输入的处理逻辑，或直接取消待执行任务。因此，一个健壮的防抖函数必须暴露 cancel 方法，并支持两种关键行为：立即执行（flush） 和 彻底取消（cancel）。
cancel 方法应区分 flush 与 cancel 语义
不能只提供一个无参数的 cancel()。理想设计是让调用方明确意图：
- cancel(true) 或 flush()：清空定时器，并立即以当前最新参数执行原函数；
- cancel(false) 或 cancel()：仅清除定时器，不执行任何调用，丢弃所有待处理状态。
这样语义清晰，避免误用。例如搜索建议场景，点击“X”清空时调用 debouncedSearch.flush()，确保提交当前已输入内容；而切换页面时调用 debouncedSearch.cancel()，防止异步回调在组件卸载后报错。
实现要点：保存上下文、参数与定时器引用
要支持 flush，函数必须在每次调用时记住最新的 this 和参数（包括可能的 rest 参数），并在 flush 时原样复用：
立即学习“Java免费学习笔记（深入）”；
- 用闭包变量缓存
lastThis、lastArgs； - 每次调用 debounced 函数时更新这些缓存，并重置定时器；
- flush 时检查缓存是否存在（即是否至少被调用过一次），存在则用
func.apply(lastThis, lastArgs)执行； - cancel 时仅清除 timerId，不碰缓存——因为 flush 可能后续触发；
- 为防内存泄漏，flush/cancel 后可将缓存设为
null（可选，取决于是否允许重复 flush）。
一个简洁可用的实现示例
以下是一个兼顾立即执行与取消能力的防抖函数：
function debounce(func, wait, immediate = false) {
let timerId = null;
let lastThis = null;
let lastArgs = [];
const debounced = function(...args) {
lastThis = this;
lastArgs = args;
if (timerId) clearTimeout(timerId);
if (immediate && !timerId) {
func.apply(this, args);
} else {
timerId = setTimeout(() => {
func.apply(lastThis, lastArgs);
timerId = null;
lastThis = null;
lastArgs = [];
}, wait);
}
};
debounced.cancel = function(flush = false) {
if (timerId) {
clearTimeout(timerId);
timerId = null;
}
if (flush && lastThis !== null) {
func.apply(lastThis, lastArgs);
lastThis = null;
lastArgs = [];
}
};
debounced.flush = function() {
debounced.cancel(true);
};
return debounced;
}
使用方式：const search = debounce(api.search, 300);，search.cancel() 取消，search.flush() 立即执行最后一次输入。
