自动完成必须用防抖,因其可避免高频输入触发冗余请求,防止响应错乱并提升性能;通过闭包保存定时器、清除前次计时、延迟执行最后一次输入,典型延迟200–400ms。
自动完成(Autocomplete)功能中,防抖(Debounce)是防止高频请求、提升性能和用户体验的关键技术。它的核心思想是:用户停止输入一段时间后,才触发搜索或请求,避免每按一次键就发一次请求。
用户在输入框中快速打字时,可能每秒触发 5–10 次 input 事件。若每次都调用 API,不仅浪费资源、增加服务器压力,还可能导致响应错乱(比如后发的请求先返回,覆盖了正确结果)。防抖通过延迟执行,只保留
最后一次有效输入的请求。
防抖函数接收目标函数和等待时间(毫秒),返回一个“被包装后”的新函数。关键点:每次触发时清除上一次定时器,重新计时。
示例代码:
function debounce(fn, delay) {
let timer = null;
return function (...args) {
clearTimeout(timer);
timer = setTimeout(() => {
fn.apply(this, args);
}, delay);
};
}
结合 input 事件与防抖函数,再配合异步请求(如 fetch)和 DOM 更新即可实现完整流程:
const input = document.getElementById('search');
const results = document.getElementById('results');
const search = debounce(async (query) => {
if (!query.trim()) {
results.innerHTML = '';
return;
}
try {
const res = await fetch(`/api/suggest?q=${encodeURIComponent(query)}`);
const data = await res.json();
results.innerHTML = data.map(item =>
`${item.text}`
).join('');
} catch (err) {
results.innerHTML = '加载失败';
}
}, 300);
input.addEventListener('input', (e) => {
search(e.target.value);
});
实际项目中还需考虑几个细节:
AbortController 配合 fetch,避免旧请求返回后覆盖新结果基本上就这些。防抖本身不复杂,但容易忽略清理逻辑和边界情况,写对一次,整个搜索体验就稳了。