Source: https://tanstack.com/pacer/latest/docs/reference/interfaces/BatcherOptions

TanStack

Pacer v0v0

Search...

+ K

Auto

Log In

TanStack StartRC

Docs Examples GitHub Contributors

TanStack Router

Docs Examples GitHub Contributors

TanStack Query

Docs Examples GitHub Contributors

TanStack Table

Docs Examples Github Contributors

TanStack Formnew

Docs Examples Github Contributors

TanStack DBbeta

Docs Github Contributors

TanStack Virtual

Docs Examples Github Contributors

TanStack Paceralpha

Docs Examples Github Contributors

TanStack Storealpha

Docs Examples Github Contributors

TanStack Devtoolsalpha

Docs Github Contributors

More Libraries

Maintainers Partners Support Learn StatsBETA Discord Merch Blog GitHub Ethos Brand Guide

Documentation

Framework

React

Version

Latest

Search...

+ K

Menu

• Home

• Frameworks

• Contributors

• GitHub

• Discord

Getting Started

• Overview
  
  core

• Quick Start
  
  core

• Installation
  
  core

• Devtools
  
  core

• React Adapter
  
  react

Guides

• Debouncing Guide
  
  core

• Async Debouncing Guide
  
  core

• Throttling Guide
  
  core

• Async Throttling Guide
  
  core

• Rate Limiting Guide
  
  core

• Async Rate Limiting Guide
  
  core

• Queuing Guide
  
  core

• Async Queuing Guide
  
  core

• Batching Guide
  
  core

• Async Batching Guide
  
  core

• Async Retrying Guide
  
  core

API Reference

• Core API Reference
  
  core

• React Hooks
  
  react

Debouncer API Reference

• DebouncerOptions
  
  core

• DebouncerState
  
  core

• AsyncDebouncerOptions
  
  core

• AsyncDebouncerState
  
  core

• debounce
  
  core

• asyncDebounce
  
  core

• Debouncer
  
  core

• AsyncDebouncer
  
  core

• ReactDebouncer
  
  react

• ReactAsyncDebouncer
  
  react

• useDebouncer
  
  react

• useDebouncedCallback
  
  react

• useDebouncedState
  
  react

• useDebouncedValue
  
  react

• useAsyncDebouncer
  
  react

• useAsyncDebouncedCallback
  
  react

Throttler API Reference

• ThrottlerOptions
  
  core

• ThrottlerState
  
  core

• AsyncThrottlerOptions
  
  core

• AsyncThrottlerState
  
  core

• throttle
  
  core

• asyncThrottle
  
  core

• Throttler
  
  core

• AsyncThrottler
  
  core

• ReactThrottler
  
  react

• ReactAsyncThrottler
  
  react

• useThrottler
  
  react

• useThrottledCallback
  
  react

• useThrottledState
  
  react

• useThrottledValue
  
  react

• useAsyncThrottler
  
  react

• useAsyncThrottledCallback
  
  react

Rate Limiter API Reference

• RateLimiterOptions
  
  core

• RateLimiterState
  
  core

• AsyncRateLimiterOptions
  
  core

• AsyncRateLimiterState
  
  core

• rateLimit
  
  core

• asyncRateLimit
  
  core

• RateLimiter
  
  core

• AsyncRateLimiter
  
  core

• ReactRateLimiter
  
  react

• ReactAsyncRateLimiter
  
  react

• useRateLimiter
  
  react

• useRateLimitedCallback
  
  react

• useRateLimitedState
  
  react

• useRateLimitedValue
  
  react

• useAsyncRateLimiter
  
  react

• useAsyncRateLimitedCallback
  
  react

Queue API Reference

• QueuerOptions
  
  core

• QueuerState
  
  core

• AsyncQueuerOptions
  
  core

• AsyncQueuerState
  
  core

• queue
  
  core

• asyncQueue
  
  core

• Queuer
  
  core

• AsyncQueuer
  
  core

• ReactQueuer
  
  react

• ReactAsyncQueuer
  
  react

• useQueuer
  
  react

• useQueuedState
  
  react

• useQueuedValue
  
  react

• useAsyncQueuer
  
  react

• useAsyncQueuedState
  
  react

Batcher API Reference

• BatcherOptions
  
  core

• BatcherState
  
  core

• AsyncBatcherOptions
  
  core

• AsyncBatcherState
  
  core

• batch
  
  core

• asyncBatch
  
  core

• Batcher
  
  core

• AsyncBatcher
  
  core

• ReactBatcher
  
  react

• ReactAsyncBatcher
  
  react

• useBatcher
  
  react

• useAsyncBatcher
  
  react

• useBatchedCallback
  
  react

• useAsyncBatchedCallback
  
  react

Debouncer Examples

• debounce
  
  react

• asyncDebounce
  
  react

• useDebouncer
  
  react

• useDebouncedCallback
  
  react

• useDebouncedState
  
  react

• useDebouncedValue
  
  react

• useAsyncDebouncer
  
  react

• useAsyncDebouncedCallback
  
  react

Throttler Examples

• throttle
  
  react

• asyncThrottle
  
  react

• useThrottler
  
  react

• useThrottledCallback
  
  react

• useThrottledState
  
  react

• useThrottledValue
  
  react

• useAsyncThrottler
  
  react

Rate Limiter Examples

• rateLimit
  
  react

• asyncRateLimit
  
  react

• useRateLimiter
  
  react

• useRateLimiterWithPersister
  
  react

• useRateLimitedCallback
  
  react

• useRateLimitedState
  
  react

• useRateLimitedValue
  
  react

• useAsyncRateLimiter
  
  react

• useAsyncRateLimiterWithPersister
  
  react

Queue Examples

• queue
  
  react

• useQueuer
  
  react

• useQueuerWithPersister
  
  react

• useQueuedState
  
  react

• useQueuedValue
  
  react

• useAsyncQueuer
  
  react

• useAsyncQueuedState
  
  react

Batcher Examples

• batch
  
  react

• asyncBatch
  
  react

• useBatcher
  
  react

• useAsyncBatcher
  
  react

• useBatchedCallback
  
  react

• useAsyncBatchedCallback
  
  react

TanStack Query Examples

• React Query Debounced Prefetch
  
  react

• React Query Throttled Prefetch
  
  react

• React Query Queued Prefetch
  
  react

Framework

React

Version

Latest

Menu

• Home

• Frameworks

• Contributors

• GitHub

• Discord

Getting Started

• Overview
  
  core

• Quick Start
  
  core

• Installation
  
  core

• Devtools
  
  core

• React Adapter
  
  react

Guides

• Debouncing Guide
  
  core

• Async Debouncing Guide
  
  core

• Throttling Guide
  
  core

• Async Throttling Guide
  
  core

• Rate Limiting Guide
  
  core

• Async Rate Limiting Guide
  
  core

• Queuing Guide
  
  core

• Async Queuing Guide
  
  core

• Batching Guide
  
  core

• Async Batching Guide
  
  core

• Async Retrying Guide
  
  core

API Reference

• Core API Reference
  
  core

• React Hooks
  
  react

Debouncer API Reference

• DebouncerOptions
  
  core

• DebouncerState
  
  core

• AsyncDebouncerOptions
  
  core

• AsyncDebouncerState
  
  core

• debounce
  
  core

• asyncDebounce
  
  core

• Debouncer
  
  core

• AsyncDebouncer
  
  core

• ReactDebouncer
  
  react

• ReactAsyncDebouncer
  
  react

• useDebouncer
  
  react

• useDebouncedCallback
  
  react

• useDebouncedState
  
  react

• useDebouncedValue
  
  react

• useAsyncDebouncer
  
  react

• useAsyncDebouncedCallback
  
  react

Throttler API Reference

• ThrottlerOptions
  
  core

• ThrottlerState
  
  core

• AsyncThrottlerOptions
  
  core

• AsyncThrottlerState
  
  core

• throttle
  
  core

• asyncThrottle
  
  core

• Throttler
  
  core

• AsyncThrottler
  
  core

• ReactThrottler
  
  react

• ReactAsyncThrottler
  
  react

• useThrottler
  
  react

• useThrottledCallback
  
  react

• useThrottledState
  
  react

• useThrottledValue
  
  react

• useAsyncThrottler
  
  react

• useAsyncThrottledCallback
  
  react

Rate Limiter API Reference

• RateLimiterOptions
  
  core

• RateLimiterState
  
  core

• AsyncRateLimiterOptions
  
  core

• AsyncRateLimiterState
  
  core

• rateLimit
  
  core

• asyncRateLimit
  
  core

• RateLimiter
  
  core

• AsyncRateLimiter
  
  core

• ReactRateLimiter
  
  react

• ReactAsyncRateLimiter
  
  react

• useRateLimiter
  
  react

• useRateLimitedCallback
  
  react

• useRateLimitedState
  
  react

• useRateLimitedValue
  
  react

• useAsyncRateLimiter
  
  react

• useAsyncRateLimitedCallback
  
  react

Queue API Reference

• QueuerOptions
  
  core

• QueuerState
  
  core

• AsyncQueuerOptions
  
  core

• AsyncQueuerState
  
  core

• queue
  
  core

• asyncQueue
  
  core

• Queuer
  
  core

• AsyncQueuer
  
  core

• ReactQueuer
  
  react

• ReactAsyncQueuer
  
  react

• useQueuer
  
  react

• useQueuedState
  
  react

• useQueuedValue
  
  react

• useAsyncQueuer
  
  react

• useAsyncQueuedState
  
  react

Batcher API Reference

• BatcherOptions
  
  core

• BatcherState
  
  core

• AsyncBatcherOptions
  
  core

• AsyncBatcherState
  
  core

• batch
  
  core

• asyncBatch
  
  core

• Batcher
  
  core

• AsyncBatcher
  
  core

• ReactBatcher
  
  react

• ReactAsyncBatcher
  
  react

• useBatcher
  
  react

• useAsyncBatcher
  
  react

• useBatchedCallback
  
  react

• useAsyncBatchedCallback
  
  react

Debouncer Examples

• debounce
  
  react

• asyncDebounce
  
  react

• useDebouncer
  
  react

• useDebouncedCallback
  
  react

• useDebouncedState
  
  react

• useDebouncedValue
  
  react

• useAsyncDebouncer
  
  react

• useAsyncDebouncedCallback
  
  react

Throttler Examples

• throttle
  
  react

• asyncThrottle
  
  react

• useThrottler
  
  react

• useThrottledCallback
  
  react

• useThrottledState
  
  react

• useThrottledValue
  
  react

• useAsyncThrottler
  
  react

Rate Limiter Examples

• rateLimit
  
  react

• asyncRateLimit
  
  react

• useRateLimiter
  
  react

• useRateLimiterWithPersister
  
  react

• useRateLimitedCallback
  
  react

• useRateLimitedState
  
  react

• useRateLimitedValue
  
  react

• useAsyncRateLimiter
  
  react

• useAsyncRateLimiterWithPersister
  
  react

Queue Examples

• queue
  
  react

• useQueuer
  
  react

• useQueuerWithPersister
  
  react

• useQueuedState
  
  react

• useQueuedValue
  
  react

• useAsyncQueuer
  
  react

• useAsyncQueuedState
  
  react

Batcher Examples

• batch
  
  react

• asyncBatch
  
  react

• useBatcher
  
  react

• useAsyncBatcher
  
  react

• useBatchedCallback
  
  react

• useAsyncBatchedCallback
  
  react

TanStack Query Examples

• React Query Debounced Prefetch
  
  react

• React Query Throttled Prefetch
  
  react

• React Query Queued Prefetch
  
  react

On this page

• Interface: BatcherOptions<TValue>

• Type Parameters

• TValue

• Properties

• getShouldExecute()?

• Parameters

• items

• batcher

• Returns

• initialState?

• key?

• maxSize?

• Default

• onExecute()?

• Parameters

• batch

• batcher

• Returns

• onItemsChange()?

• Parameters

• batcher

• Returns

• started?

• Default

• wait?

• Default

BatcherOptions

Copy Markdown

Interface: BatcherOptions<TValue>
=================================

Defined in: batcher.ts:52

Options for configuring a Batcher instance

Type Parameters
--------------- ### TValue

TValue

Properties
---------- ### getShouldExecute()?

ts

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


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

Defined in: batcher.ts:57

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

#### Parameters ##### items

TValue[]

##### batcher

Batcher <TValue>

#### Returns

boolean

---

### initialState?

ts

optional initialState: Partial<BatcherState<TValue>>;


optional initialState: Partial<BatcherState<TValue>>;

Defined in: batcher.ts:61

Initial state for the batcher

---

### key?

ts

optional key: string;


optional key: string;

Defined in: batcher.ts:66

Optional key to identify this batcher instance. If provided, the batcher will be identified by this key in the devtools and PacerProvider if applicable.

---

### maxSize?

ts

optional maxSize: number;


optional maxSize: number;

Defined in: batcher.ts:71

Maximum number of items in a batch

#### Default

ts

Infinity


Infinity

---

### onExecute()?

ts

optional onExecute: (batch, batcher) => void;


optional onExecute: (batch, batcher) => void;

Defined in: batcher.ts:75

Callback fired after a batch is processed

#### Parameters ##### batch

TValue[]

##### batcher

Batcher <TValue>

#### Returns

void

---

### onItemsChange()?

ts

optional onItemsChange: (batcher) => void;


optional onItemsChange: (batcher) => void;

Defined in: batcher.ts:79

Callback fired after items are added to the batcher

#### Parameters ##### batcher

Batcher <TValue>

#### Returns

void

---

### started?

ts

optional started: boolean;


optional started: boolean;

Defined in: batcher.ts:84

Whether the batcher should start processing immediately

#### Default

ts

true


true

---

### wait?

ts

optional wait: number | (batcher) => number;


optional wait: number | (batcher) => number;

Defined in: batcher.ts:91

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

Edit on GitHub

useAsyncQueuedState

BatcherState

Partners Become a Partner