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

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: QueuerOptions<TValue>

• Type Parameters

• TValue

• Properties

• addItemsTo?

• Default

• expirationDuration?

• getIsExpired()?

• Parameters

• item

• addedAt

• Returns

• getItemsFrom?

• Default

• getPriority()?

• Parameters

• item

• Returns

• initialItems?

• initialState?

• key?

• maxSize?

• onExecute()?

• Parameters

• item

• queuer

• Returns

• onExpire()?

• Parameters

• item

• queuer

• Returns

• onItemsChange()?

• Parameters

• queuer

• Returns

• onReject()?

• Parameters

• item

• queuer

• Returns

• started?

• wait?

• Default

QueuerOptions

Copy Markdown

Interface: QueuerOptions<TValue>
================================

Defined in: queuer.ts:83

Options for configuring a Queuer instance.

These options control queue behavior, item expiration, callbacks, and more.

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

TValue

Properties
---------- ### addItemsTo?

ts

optional addItemsTo: QueuePosition;


optional addItemsTo: QueuePosition;

Defined in: queuer.ts:88

Default position to add items to the queuer

#### Default

ts

'back'


'back'

---

### expirationDuration?

ts

optional expirationDuration: number;


optional expirationDuration: number;

Defined in: queuer.ts:93

Maximum time in milliseconds that an item can stay in the queue If not provided, items will never expire

---

### getIsExpired()?

ts

optional getIsExpired: (item, addedAt) => boolean;


optional getIsExpired: (item, addedAt) => boolean;

Defined in: queuer.ts:98

Function to determine if an item has expired If provided, this overrides the expirationDuration behavior

#### Parameters ##### item

TValue

##### addedAt

number

#### Returns

boolean

---

### getItemsFrom?

ts

optional getItemsFrom: QueuePosition;


optional getItemsFrom: QueuePosition;

Defined in: queuer.ts:103

Default position to get items from during processing

#### Default

ts

'front'


'front'

---

### getPriority()?

ts

optional getPriority: (item) => number;


optional getPriority: (item) => number;

Defined in: queuer.ts:108

Function to determine priority of items in the queuer Higher priority items will be processed first

#### Parameters ##### item

TValue

#### Returns

number

---

### initialItems?

ts

optional initialItems: TValue[];


optional initialItems: TValue[];

Defined in: queuer.ts:112

Initial items to populate the queuer with

---

### initialState?

ts

optional initialState: Partial<QueuerState<TValue>>;


optional initialState: Partial<QueuerState<TValue>>;

Defined in: queuer.ts:116

Initial state for the queuer

---

### key?

ts

optional key: string;


optional key: string;

Defined in: queuer.ts:121

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

---

### maxSize?

ts

optional maxSize: number;


optional maxSize: number;

Defined in: queuer.ts:125

Maximum number of items allowed in the queuer

---

### onExecute()?

ts

optional onExecute: (item, queuer) => void;


optional onExecute: (item, queuer) => void;

Defined in: queuer.ts:129

Callback fired whenever an item is removed from the queuer

#### Parameters ##### item

TValue

##### queuer

Queuer <TValue>

#### Returns

void

---

### onExpire()?

ts

optional onExpire: (item, queuer) => void;


optional onExpire: (item, queuer) => void;

Defined in: queuer.ts:133

Callback fired whenever an item expires in the queuer

#### Parameters ##### item

TValue

##### queuer

Queuer <TValue>

#### Returns

void

---

### onItemsChange()?

ts

optional onItemsChange: (queuer) => void;


optional onItemsChange: (queuer) => void;

Defined in: queuer.ts:137

Callback fired whenever an item is added or removed from the queuer

#### Parameters ##### queuer

Queuer <TValue>

#### Returns

void

---

### onReject()?

ts

optional onReject: (item, queuer) => void;


optional onReject: (item, queuer) => void;

Defined in: queuer.ts:141

Callback fired whenever an item is rejected from being added to the queuer

#### Parameters ##### item

TValue

##### queuer

Queuer <TValue>

#### Returns

void

---

### started?

ts

optional started: boolean;


optional started: boolean;

Defined in: queuer.ts:145

Whether the queuer should start processing tasks immediately

---

### wait?

ts

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


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

Defined in: queuer.ts:151

Time in milliseconds to wait between processing items. Can be a number or a function that returns a number.

#### Default

ts

0


0

Edit on GitHub

useAsyncRateLimitedCallback

QueuerState

Partners Become a Partner