debounce 通过清除旧定时器并重设新定时器,将高频事件回调压缩为最后一次触发执行;适用于 input、scroll、resize 等密集事件,避免卡顿或请求爆炸,标准实现为 trailing 模式。

直接用 debounce 包一层事件回调函数,就能把高频触发压成“最后一次才执行”。它不是加个属性或改个标签就能生效的,必须写 JavaScript 逻辑,且关键点在于「清除旧定时器 + 重设新定时器」。
为什么 input、scroll、resize 事件需要 debounce
这些事件在用户操作时会密集触发:比如滚动页面,onscroll 可能在 100ms 内触发 20+ 次;输入框每敲一个字就触发 oninput。如果回调里有 DOM 查询、计算布局或发请求,页面立刻卡顿或请求爆炸。
防抖不改变事件本身,只控制回调执行时机 —— 它让函数“等一等”,直到用户停手了再干活。
- 搜索框输入:避免每输一个字就发一次请求
- 窗口缩放:
onresize触发太密,重排版逻辑只需执行一次 - 表单校验:用户还在打字,别急着标红
debounce 函数怎么写才不踩坑
最简可用版本是闭包 + setTimeout + clearTimeout,但要注意三个易错点:
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
fn.apply(this, arguments)必须保留原始this和参数,否则事件回调里拿不到event或target - 不能漏掉
clearTimeout(timer),否则旧定时器会在后台偷偷执行,导致“明明停手了却还触发” - 延迟时间(如
300)不是越小越好:小于 100ms 用户感知不到“等待”,但依然频繁触发;大于 500ms 会明显滞后,建议 200–400ms 之间试调
示例:
function debounce(fn, delay) {
let timer;
return function(...args) {
clearTimeout(timer);
timer = setTimeout(() => fn.apply(this, args), delay);
};
}
绑定时这样用:
const searchInput = document.getElementById('search');
searchInput.addEventListener('input', debounce(function(e) {
console.log('发送搜索请求:', e.target.value);
}, 300));
debounce 和 throttle 在 HTML 事件里怎么选
看你要不要“立刻响应第一次”:
- 用
debounce:搜索建议、校验、resize 后重绘 —— 关键是“等用户停下来”,不在乎中间过程 - 用
throttle:滚动监听加载更多、鼠标移动画布、游戏按键 —— 需要持续反馈,但不能太密
注意:HTML 中没有原生 debounce 属性,也别信“给 addEventListener 加第三个参数就能防抖”这种说法 —— 那个参数是 options,和防抖无关。
真正容易被忽略的是:debounce 本身不处理「首次触发是否立即执行」的问题。如果你需要“马上执行一次,之后再防抖”,就得实现带 leading 选项的版本,而标准写法默认是 trailing(只在停止后执行)。


















