Framework
Version
Debouncer API Reference
Throttler API Reference
Rate Limiter API Reference
Queue API Reference
Batcher API Reference

AsyncBatcherOptions

Interface: AsyncBatcherOptions<TValue>

Defined in: async-batcher.ts:86

Options for configuring an AsyncBatcher instance

Type Parameters

TValue

Properties

getShouldExecute()?

ts
optional getShouldExecute: (items, batcher) => boolean;
optional getShouldExecute: (items, batcher) => boolean;

Defined in: async-batcher.ts:91

Custom function to determine if a batch should be processed Return true to process the batch immediately

Parameters

items

TValue[]

batcher

AsyncBatcher<TValue>

Returns

boolean


initialState?

ts
optional initialState: Partial<AsyncBatcherState<TValue>>;
optional initialState: Partial<AsyncBatcherState<TValue>>;

Defined in: async-batcher.ts:98

Initial state for the async batcher


maxSize?

ts
optional maxSize: number;
optional maxSize: number;

Defined in: async-batcher.ts:103

Maximum number of items in a batch

Default

ts
Infinity
Infinity

onError()?

ts
optional onError: (error, failedItems, batcher) => void;
optional onError: (error, failedItems, batcher) => void;

Defined in: async-batcher.ts:109

Optional error handler for when the batch function throws. If provided, the handler will be called with the error and batcher instance. This can be used alongside throwOnError - the handler will be called before any error is thrown.

Parameters

error

unknown

failedItems

TValue[]

batcher

AsyncBatcher<TValue>

Returns

void


onExecute()?

ts
optional onExecute: (batcher) => void;
optional onExecute: (batcher) => void;

Defined in: async-batcher.ts:117

Callback fired after a batch is processed

Parameters

batcher

AsyncBatcher<TValue>

Returns

void


onItemsChange()?

ts
optional onItemsChange: (batcher) => void;
optional onItemsChange: (batcher) => void;

Defined in: async-batcher.ts:121

Callback fired after items are added to the batcher

Parameters

batcher

AsyncBatcher<TValue>

Returns

void


onSettled()?

ts
optional onSettled: (batcher) => void;
optional onSettled: (batcher) => void;

Defined in: async-batcher.ts:125

Optional callback to call when a batch is settled (completed or failed)

Parameters

batcher

AsyncBatcher<TValue>

Returns

void


onSuccess()?

ts
optional onSuccess: (result, batcher) => void;
optional onSuccess: (result, batcher) => void;

Defined in: async-batcher.ts:129

Optional callback to call when a batch succeeds

Parameters

result

any

batcher

AsyncBatcher<TValue>

Returns

void


started?

ts
optional started: boolean;
optional started: boolean;

Defined in: async-batcher.ts:134

Whether the batcher should start processing immediately

Default

ts
true
true

throwOnError?

ts
optional throwOnError: boolean;
optional throwOnError: boolean;

Defined in: async-batcher.ts:140

Whether to throw errors when they occur. Defaults to true if no onError handler is provided, false if an onError handler is provided. Can be explicitly set to override these defaults.


wait?

ts
optional wait: number | (asyncBatcher) => number;
optional wait: number | (asyncBatcher) => number;

Defined in: async-batcher.ts:147

Maximum time in milliseconds to wait before processing a batch. If the wait duration has elapsed, the batch will be processed. If not provided, the batch will not be triggered by a timeout.

Default

ts
Infinity
Infinity
Subscribe to Bytes

Your weekly dose of JavaScript news. Delivered every Monday to over 100,000 devs, for free.

Bytes

No spam. Unsubscribe at any time.