이 글은 블로그 화면을 확인하려고 넣어 둔 샘플 글입니다. 실제 글을 쓰면 지워도 됩니다.
검색창에 글자를 칠 때마다 서버에 요청을 보내면 낭비가 큽니다. 사용자가 입력을 잠깐 멈췄을 때 한 번만 요청을 보내면 충분합니다. 이럴 때 쓰는 기법이 디바운스입니다.
동작 방식
디바운스는 호출이 들어올 때마다 타이머를 새로 겁니다. 정해 둔 시간 안에 다시 호출되면 이전 타이머를 지우고 처음부터 기다립니다. 결국 마지막 호출 뒤로 조용한 시간이 지나야 함수가 실행됩니다.
구현
export function debounce<Args extends unknown[]>(
fn: (...args: Args) => void,
wait = 300,
) {
let timer: ReturnType<typeof setTimeout> | undefined;
return (...args: Args) => {
if (timer !== undefined) clearTimeout(timer);
timer = setTimeout(() => {
timer = undefined;
fn(...args);
}, wait);
};
}
사용 예
const input = document.querySelector<HTMLInputElement>('#search');
const search = debounce((keyword: string) => {
console.log(`검색어: ${keyword}`);
}, 400);
input?.addEventListener('input', (event) => {
search((event.target as HTMLInputElement).value);
});
wait 값은 너무 짧으면 효과가 없고, 너무 길면 화면이 굼뜨게 느껴집니다. 검색창이라면 300에서 500밀리초 사이가 무난합니다.
정리
- 연속된 호출 중 마지막 호출만 실행합니다.
clearTimeout으로 이전 타이머를 지우는 것이 핵심입니다.- 스크롤처럼 일정 간격으로 계속 실행해야 한다면 스로틀이 더 맞을 수 있습니다.