通过返回一个包含状态标记的闭包函数,并在内部逻辑中根据该标记决定执行时机,即可精确控制节流函数的首次和末次触发。具体做法是维护一个 `leading` 布尔值参数,当 `leading` 为 true 时,在定时器启动前立即执行一次(首次触发),并锁定后续调用;当定时器结束时,重置 `leading` 并允许下一次立即执行。若需支持末次触发,则结合 `trailing` 参数,在定时器到期时检查是否还有未执行的调用,若有则执行最后一次(末次触发)。

如何实现带首次触发的基础节流
要实现仅在第一次调用时立即执行,后续调用被忽略直到时间窗口结束的节流函数,核心在于使用一个标志位来记录当前是否处于“冷却期”。在函数内部,我们检查这个标志位,如果为 false,说明可以立即执行,此时将标志位置为 true 并启动定时器;如果为 true,则直接返回,不做任何操作。定时器结束后,将标志位重置为 false,从而允许下一次调用再次立即执行。

function throttle(func, wait) {
let leading = true;
let timeoutId = null;
return function(...args) {
if (leading) {
func.apply(this, args);
leading = false;
}
if (!timeoutId) {
timeoutId = setTimeout(() => {
timeoutId = null;
leading = true;
}, wait);
}
};
}
上述代码定义了一个 throttle 函数,它接受目标函数 func 和时间间隔 wait。返回的包装函数首先检查 leading 变量。如果 leading 为真,则立即调用 func 并将 leading 设为假。接着,如果当前没有正在运行的定时器(timeoutId 为空),则创建一个新的定时器。定时器回调中会将 timeoutId 清空,并将 leading 重置为真,从而开启下一个周期的首次触发机会。这种实现确保了在连续快速调用时,只有第一次调用会立即生效,之后的调用都会被忽略,直到定时器结束。
如何同时支持末次触发以处理边界情况
仅支持首次触发的节流函数在处理用户交互如鼠标移动或窗口缩放时,可能会导致最后一次动作未被记录。为了解决这个问题,我们需要引入 trailing 选项。当 trailing 为 true 时,如果在定时器期间有调用发生,且定时器结束时距离上次执行已超过阈值,则在定时器回调中执行最后一次调用。这通常通过记录最后一次调用的参数来实现,以便在末次触发时使用最新的上下文。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

function throttleWithTrailing(func, wait, options = {}) {
let leading = options.leading !== false;
let trailing = options.trailing !== false;
let timeoutId = null;
let lastArgs = null;
let lastThis = null;
return function(...args) {
lastThis = this;
lastArgs = args;
if (timeoutId === null) {
if (leading) {
func.apply(this, args);
}
timeoutId = setTimeout(() => {
timeoutId = null;
if (trailing && lastArgs) {
func.apply(lastThis, lastArgs);
lastArgs = null;
lastThis = null;
}
}, wait);
}
};
}
这段代码扩展了之前的实现,增加了 options 参数来控制 leading 和 trailing 行为。它引入了 lastArgs 和 lastThis 来缓存最后一次调用的参数和上下文。在定时器启动时,如果 leading 为真,则立即执行。定时器回调中,如果 trailing 为真且存在缓存的参数(意味着在定时器期间有过调用),则执行最后一次调用。这确保了即使在高频调用序列的最后,用户的意图也能被正确捕获。例如,在搜索框输入时,首次输入立即发起请求,而停止输入后的最后一次完整输入也会触发请求,避免遗漏。
基于程序中某个输入、条件或结果的具体问题
在实际使用中,如果用户在节流时间窗口内持续进行操作,但最后一次操作后没有新的调用,如何确保程序能正确处理这一状态?在上述实现中,通过 lastArgs 的存在与否来判断。如果定时器结束时 lastArgs 不为空,说明在定时器启动后有调用发生,因此执行末次触发。如果 lastArgs 为空,说明自定时器启动以来没有新调用,或者上一次调用已在首次触发时处理完毕,此时不执行额外操作。这种机制保证了无论用户何时停止操作,只要有一次调用落在时间窗口内,就能得到响应。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










