[샘플 글] 자바스크립트 디바운스 함수 직접 만들기

입력이 멈춘 뒤에만 함수를 실행하는 디바운스를 짧게 구현해 봅니다.

이 글은 블로그 화면을 확인하려고 넣어 둔 샘플 글입니다. 실제 글을 쓰면 지워도 됩니다.

검색창에 글자를 칠 때마다 서버에 요청을 보내면 낭비가 큽니다. 사용자가 입력을 잠깐 멈췄을 때 한 번만 요청을 보내면 충분합니다. 이럴 때 쓰는 기법이 디바운스입니다.

동작 방식

디바운스는 호출이 들어올 때마다 타이머를 새로 겁니다. 정해 둔 시간 안에 다시 호출되면 이전 타이머를 지우고 처음부터 기다립니다. 결국 마지막 호출 뒤로 조용한 시간이 지나야 함수가 실행됩니다.

구현

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으로 이전 타이머를 지우는 것이 핵심입니다.
  • 스크롤처럼 일정 간격으로 계속 실행해야 한다면 스로틀이 더 맞을 수 있습니다.