본문으로 건너뛰기

함수: injectBatcher()

function injectBatcher<TValue, TSelected>(
fn,
options,
selector): AngularBatcher<TValue, TSelected>;

정의 위치: angular-pacer/src/batcher/injectBatcher.ts:85

Batcher 인스턴스를 생성하고 관리하는 Angular 함수입니다.

Batcher 기능에 직접 접근할 수 있게 해 주는 저수준 함수입니다. 원하는 상태 관리 솔루션과 통합할 수 있습니다.

Batcher는 항목을 모아 다음과 같은 구성 가능한 조건에 따라 배치로 처리합니다.

  • 최대 배치 크기
  • 시간 기반 배칭(X밀리초 후 처리)
  • getShouldExecute를 통한 사용자 지정 배치 처리 로직

상태 관리와 셀렉터

이 함수는 TanStack Store로 상태를 관리하고 이를 Angular 시그널로 래핑합니다. selector 매개변수로 어떤 상태 변경이 시그널 업데이트를 트리거할지 지정할 수 있으며, 관련 없는 상태가 변경될 때 불필요한 업데이트를 방지하여 성능을 최적화합니다.

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

제거 시 정리

기본적으로 컴포넌트가 제거되면 대기 중인 배치를 취소합니다. onUnmount 옵션으로 이 동작을 사용자 지정할 수 있습니다. 예를 들어 대기 중인 작업을 대신 플러시하려면 다음과 같이 설정합니다.

const batcher = injectBatcher(fn, {
maxSize: 5,
onUnmount: (b) => b.flush()
});

타입 매개변수

TValue

TValue

TSelected

TSelected = { }

매개변수

fn

(items) => void

options

AngularBatcherOptions&lt;TValue, TSelected> = {}

selector

(state) => TSelected

반환값

AngularBatcher&lt;TValue, TSelected>

예시

// Default behavior - no reactive state subscriptions
const batcher = injectBatcher(
(items) => console.log('Processing batch:', items),
{ maxSize: 5, wait: 2000 }
);

// Add items
batcher.addItem('task1');

// Access the selected state
const { items, isPending } = batcher.state();