Zero-dependency로 구현하는 TypeScript 함수 실행 제어 전략

Context

잦은 키 입력으로 인한 UI 프리징 현상 발생. 중복 API 호출로 인한 서버 부하 증가. 함수 실행 타이밍 제어를 위한 정밀한 메커니즘 부재.

Technical Solution

• Generic 기반의 Full TypeScript 지원으로 타입 안전성 확보
• 특정 시간 동안 호출 중단 후 마지막 한 번만 실행하는 Debounce 로직 구현
• 정해진 시간 간격 내 최대 1회만 실행을 보장하는 Throttle 메커니즘 적용
• 설정된 시간 윈도우 내 최대 호출 횟수를 제한하는 RateLimit 구조 설계
• 첫 호출 시에만 로직을 수행하고 이후 호출을 무시하는 Once 패턴 제공
• ESM/CJS 듀얼 출력 및 Tree-shaking 지원으로 번들 크기 최소화

Key Takeaway

함수 실행 빈도 제어는 단순한 성능 최적화를 넘어 사용자 경험과 시스템 안정성을 결정하는 핵심 설계 요소임. 런타임 환경에 구애받지 않는 가벼운 유틸리티 설계를 통해 인프라 비용 절감과 응답성 향상을 동시에 달성 가능.