闭包不直接节流,而是封装队列、定时器与配置实现智能批量上报:通过iife隔离logqueue、timerid及maxbatchsize/flushinterval,track()自动注入上下文并触发满量或定时上报,失败回填保障不丢数据,flush()/destroy()提供手动控制与资源清理。

闭包本身不直接“节流”,但它能封装状态和定时逻辑,为智能合并与批量上报提供干净、隔离的执行环境。关键不是用闭包做节流函数(如 throttle/debounce),而是用它把队列、计时器、配置和上报策略封进一个私有作用域,让 SDK 在内存中自主决策“什么时候发、发多少、怎么兜底”。
用闭包封装缓冲队列与上报节奏
通过立即执行函数(IIFE)创建封闭作用域,内部维护:
- logQueue:暂存待上报的日志对象数组,不暴露给全局
- timerId:控制上报时机的定时器引用,避免重复启动
-
配置项:如
maxBatchSize(满多少条就发)、flushInterval(最多等多久)
这样既防止变量污染,又确保多个 SDK 实例互不干扰——比如页面里同时加载用户行为埋点和性能监控两个 SDK,它们各自有独立队列和定时器。
track() 方法自动聚合 + 智能触发
对外只暴露一个 track() 方法,每次调用都做三件事:
- 自动注入上下文:URL、UA、时间戳、设备信息等,无需调用方重复传
- 将日志推入
logQueue,并检查是否达到maxBatchSize - 若队列为空且无活跃定时器,才启动新的
setInterval,避免冗余计时
例如:设 maxBatchSize = 5,用户连续点击 5 次按钮,第 5 次调用 track() 会立刻触发上报,而不是干等定时器;若点击间隔长,10 秒后也会强制发一次。
批量发送 + 失败不丢数据
定时器触发时,并不是直接清空原队列再发,而是先拷贝再清空:
-
const batch = [...logQueue]; logQueue.length = 0;—— 防止上报过程中新日志被漏掉 - 优先用
navigator.sendBeacon()发送,关页也不丢;不支持时降级为new Image().src(GET 请求,无跨域问题) - 上报失败时,把
batch重新插回logQueue开头,下次定时继续尝试,直到成功
这种“先复制、再清理、失败回填”的设计,比简单清空队列更健壮,尤其适合弱网或服务端临时不可用的场景。
手动控制与资源清理
除了自动机制,还提供两个关键辅助方法:
-
flush():立即发送当前所有缓存日志,常用于beforeunload或pagehide事件中,确保最后行为不丢失 -
destroy():清除定时器、清空队列、解绑监听,方便在单页应用切换模块或测试环境卸载 SDK 时释放资源
这两个方法都依赖闭包内保存的 timerId 和 logQueue 引用,外部无法篡改,保证操作安全可靠。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











