节流函数的核心职责是限频而非合并参数，实际需叠加参数缓存与批量处理机制：用闭包维护 pendingArgs 队列和 isScheduled 标记，结合 queueMicrotask 实现零延迟批量合并，并通过 func.call(this, args) 保持上下文。
节流函数本身不负责“合并参数与状态”，它的职责是限频——控制执行次数。但实际开发中，高频事件（如滚动、输入、鼠标移动）常携带不同参数，而业务逻辑又需要累积或聚合这些变化（比如批量上报坐标、合并表单字段、去重 ID 列表），这时就需要在节流基础上叠加“参数缓存 + 批量处理”机制。
用闭包缓存参数并延迟统一处理
核心思路是：节流只管“多久执行一次”，内部再维护一个待处理队列，每次触发时把参数推入队列，等节流允许执行时，一次性消费全部缓存项。
- 用数组（pendingArgs）暂存每次调用的参数（如 event、value、position）
- 用布尔标记（isProcessing）避免重复调度微任务或定时器
- 节流判断通过后，清空队列并传给原函数——此时原函数接收的是“合并后的数据结构”，而非单次参数
结合微任务实现零延迟批量合并
比起 setTimeout，queueMicrotask 更适合这类场景：它保证在当前同步代码结束后、下一个宏任务开始前执行，既不会打断渲染，也不会引入额外延迟，且天然支持“多次添加只触发一次”。
- 每次触发节流函数，只做两件事：push 参数 + 确保已注册一次微任务
- 微任务回调里执行合并逻辑（如去重、求和、拼接对象）并调用目标函数
- 无需手动 clearTimeout 或管理 lastTime，状态更轻量
保留 this 和事件语义的关键细节
如果原始回调依赖 this（如 DOM 元素上下文）或需要访问原生 event 对象，直接缓存 arguments 并 apply 是安全的；但要注意：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 必须用 func.apply(this, args) 还原执行上下文，否则 this 会丢失
- 若监听时用了 passive: true，event 可能不可读写，应避免修改其属性
- 不建议在节流内部对 event 做状态标记（如 event.handled = true），因多次触发可能共享同一 event 实例
一个可运行的合并式节流示例
以下函数支持参数累积、微任务批量处理，并正确传递 this 和参数：
function throttleWithBatch(func, delay) {
let pendingArgs = [];
let isScheduled = false;
const batchHandler = () => {
if (pendingArgs.length === 0) return;
// 合并逻辑示例：去重 + 提取所有 event.target.id
const uniqueIds = [...new Set(pendingArgs.map(args => args[0]?.target?.id))].filter(Boolean);
func.call(this, uniqueIds); // 传入合并结果
pendingArgs = [];
isScheduled = false;
};
return function(...args) {
pendingArgs.push(args);
if (!isScheduled) {
isScheduled = true;
queueMicrotask(batchHandler.bind(this));
}
};
}
使用时：window.addEventListener('scroll', throttleWithBatch(handleScroll, 16)); —— 滚动中不断收集 target.id，每帧最多合并执行一次。
