节流间隔是两次合法执行间的最小时间差而非延迟等待时间,需通过闭包精确维护lastTime等状态,确保执行时机准确;leading和trailing行为需协同闭包变量与定时器实现,时间计算须统一用Date.now()并采用≥判断。

节流间隔不是简单设个数字就完事,它必须和闭包中维护的状态严格对齐,否则会出现执行时机错乱、漏触发或重复触发。
节流间隔决定的是“最小允许执行间隔”
这个值不是延迟等待时间,而是两次合法执行之间必须满足的最小时间差。比如设为 300ms,意思是:上一次执行完毕后,至少要等满 300ms,下一次调用才可能被执行。
- 它不保证“每 300ms 必定执行一次”,只保证“不会比 300ms 更频繁”
- 如果用户在 200ms 内连续点击 5 次,节流函数只会放行第一次(或最后一次,取决于实现策略),其余 4 次被忽略
- 实际执行节奏取决于用户触发频率——高频触发时接近固定间隔,低频触发时每次都会立即执行
闭包状态必须精确记录上次执行时间点
时间戳方案依赖一个始终存活的 lastTime 变量,它不能重置、不能丢失,且必须在每次成功执行后更新为当前时间。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- lastTime 初始值很重要:通常设为 0 或 Date.now(),影响首次触发是否立即执行
- 更新时机必须严格在 func 执行完成之后,不能提前也不能遗漏
- 若使用定时器方案,则靠 timer ID 是否为空来判断是否处于“可执行窗口”,本质仍是闭包内状态的布尔表达
leading 和 trailing 行为由闭包变量协同控制
标准节流默认只支持“首触发即执行”(leading),但真实业务常需“末次补发”(trailing)。这需要额外闭包变量配合定时器逻辑:
立即学习“Java免费学习笔记(深入)”;
- 启用 trailing 时,需在每次被节流的调用中启动一个延迟定时器,把参数暂存,并在 wait 结束后执行
- 必须用闭包保存 pendingArgs、pendingThis 和 timer,确保跨调用间上下文不丢失
- leading: true + trailing: true 组合下,闭包需同时管理两个时间锚点:上一次立即执行时间 & 上一次 pending 定时器设定时间
间隔单位统一用毫秒,时间获取必须一致
所有时间计算必须基于同一来源,否则因精度或时区差异导致判断失效。
- 推荐统一用 Date.now(),避免 new Date().getTime() 的构造开销
- 不要混用 performance.now()(相对高精度但非绝对时间)与 Date.now(),二者不可直接相减
- 计算差值时用 currentTime - lastTime >= delay,而非 >,避免因浮点误差或极小时间抖动导致临界点失效

















