본문으로 건너뛰기

함수: injectRateLimitedSignal()

function injectRateLimitedSignal<TValue, TSelected>(
   value, 
   initialOptions, 
selector?): RateLimitedSignal<TValue, TSelected>;

정의 위치: angular-pacer/src/rate-limiter/injectRateLimitedSignal.ts:57

Angular 시그널과 요청률 제한 기능을 결합한 요청률 제한 상태 시그널을 생성하는 Angular 함수입니다. 이 함수는 현재 요청률 제한 값과 이를 업데이트하는 메서드를 모두 제공합니다.

요청률 제한은 단순한 "하드 리밋" 방식입니다. 제한에 도달할 때까지 모든 업데이트를 허용하고, 그 후 창이 초기화될 때까지 후속 업데이트를 차단합니다. 스로틀이나 디바운스와 달리 업데이트 간격을 조정하거나 지능적으로 병합하지 않습니다.

이 함수는 다음과 같은 호출 가능한 객체를 반환합니다.

  • rateLimited(): 현재 요청률 제한 값을 가져옵니다.
  • rateLimited.set(...): 요청률 제한 값을 설정하거나 업데이트합니다(maybeExecute를 통해 요청률 제한됨).
  • rateLimited.rateLimiter: 추가 제어 메서드와 상태 시그널을 제공하는 요청률 제한기 인스턴스입니다.

상태 관리와 셀렉터​

이 함수는 내부 요청률 제한기 인스턴스를 통해 TanStack Store로 반응형 상태를 관리합니다. selector 매개변수로 어떤 요청률 제한기 상태 변경이 시그널 업데이트를 트리거할지 지정할 수 있으며, 관련 없는 상태가 변경될 때 불필요한 구독을 방지하여 성능을 최적화합니다.

기본적으로 반응형 상태 구독은 없습니다. 반응형 상태를 추적하려면 셀렉터 함수를 제공하여 명시적으로 활성화해야 합니다. 이를 통해 불필요한 업데이트를 방지하고 컴포넌트가 상태 변경을 추적할 시점을 완전히 제어할 수 있습니다.

타입 매개변수​

TValue​

TValue

TSelected​

TSelected = { }

매개변수​

value​

TValue

initialOptions​

RateLimiterOptions&lt;Setter&lt;TValue>>

selector?​

(state) => TSelected

반환값​

RateLimitedSignal&lt;TValue, TSelected>

예시​

// Default behavior - no reactive state subscriptions
const rateLimited = injectRateLimitedSignal(0, {
  limit: 5,
  window: 60000,
  windowType: 'sliding'
});

// Opt-in to reactive updates when limit state changes
const rateLimited = injectRateLimitedSignal(
  0,
  { limit: 5, window: 60000 },
  (state) => ({ rejectionCount: state.rejectionCount })
);