要实现防抖立即执行后取消,核心做法是保留一个内部定时器引用,并在返回的函数中暴露一个 cancel 方法。当触发立即执行时,先执行回调并清空定时器;调用 cancel 时,只需检查定时器是否存在并清除它,从而阻止后续的非立即执行逻辑。

如何构建支持立即执行的防抖函数
构建该函数的关键在于处理 leading 和 trailing 两个参数。在函数内部定义一个 timer 变量用于存储定时器 ID。每次调用返回的函数时,如果 timer 存在,说明处于等待期,此时直接返回。如果 leading 为真且 timer 不存在,则立即执行回调并设置 timer。否则,启动一个新的定时器来执行 trailing 逻辑。最后,通过闭包返回一个包含 cancel 方法的对象或函数属性。

function debounce(func, wait, immediate = false) {
let timer = null;
const debounced = function (...args) {
if (timer) {
return;
}
if (immediate) {
func.apply(this, args);
timer = setTimeout(() => {
timer = null;
}, wait);
} else {
timer = setTimeout(() => {
func.apply(this, args);
timer = null;
}, wait);
}
};
debounced.cancel = function () {
if (timer) {
clearTimeout(timer);
timer = null;
}
};
return debounced;
}
如何实现防抖函数的取消功能
取消功能的实现依赖于对内部 timer 状态的访问。在上面的代码结构中,debounced 函数被赋予了 cancel 属性。这个属性指向一个匿名函数,该函数检查 timer 是否不为空。如果不为空,调用 clearTimeout 清除定时器,并将 timer 重置为 null。这样做的效果是,如果之前触发了 leading 执行,后续的 trailing 执行会被取消;如果之前触发了 trailing 执行(即设置了定时器),则该定时器的回调永远不会被执行。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
立即学习“Java免费学习笔记(深入)”;

// 使用示例
const handleInput = debounce(function(value) {
console.log('Executed:', value);
}, 300, true); // 立即执行模式
handleInput('first'); // 立即输出 'Executed: first'
handleInput.cancel(); // 取消可能的 trailing 执行(虽然这里没有设置 trailing)
// 更典型的场景:leading=false, trailing=true
const search = debounce(function(query) {
console.log('Search:', query);
}, 500, false);
search('query1'); // 500ms 后输出 'Search: query1'
search.cancel(); // 取消上述 pending 的执行
基于立即执行模式下 cancel 的具体行为验证
在立即执行(immediate = true)模式下,cancel 的作用主要是清理状态,防止重复触发或确保后续调用能正常进入下一个周期。例如,如果在立即执行后立即调用 cancel,由于 timer 已经被设置为一个即将归零的定时器,cancel 会清除这个定时器,使 timer 变为 null。这意味着下一次调用防抖函数时,会再次触发立即执行,而不是因为 timer 的存在而被忽略。这种机制确保了防抖函数在取消后能够重新响应新的输入。

















