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

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: AsyncThrottlerOptions<TFn>

• Type Parameters

• TFn

• Properties

• asyncRetryerOptions?

• enabled?

• initialState?

• key?

• leading?

• onError()?

• Parameters

• error

• args

• asyncThrottler

• Returns

• onSettled()?

• Parameters

• args

• asyncThrottler

• Returns

• onSuccess()?

• Parameters

• result

• args

• asyncThrottler

• Returns

• throwOnError?

• trailing?

• wait

AsyncThrottlerOptions

Copy Markdown

Interface: AsyncThrottlerOptions<TFn>
=====================================

Defined in: async-throttler.ts:76

Options for configuring an async throttled function

Type Parameters
--------------- ### TFn

TFn extends AnyAsyncFunction

Properties
---------- ### asyncRetryerOptions?

ts

optional asyncRetryerOptions: AsyncRetryerOptions<TFn>;


optional asyncRetryerOptions: AsyncRetryerOptions<TFn>;

Defined in: async-throttler.ts:80

Options for configuring the underlying async retryer

---

### enabled?

ts

optional enabled: boolean | (throttler) => boolean;


optional enabled: boolean | (throttler) => boolean;

Defined in: async-throttler.ts:86

Whether the throttler is enabled. When disabled, maybeExecute will not trigger any executions. Can be a boolean or a function that returns a boolean. Defaults to true.

---

### initialState?

ts

optional initialState: Partial<AsyncThrottlerState<TFn>>;


optional initialState: Partial<AsyncThrottlerState<TFn>>;

Defined in: async-throttler.ts:90

Initial state for the async throttler

---

### key?

ts

optional key: string;


optional key: string;

Defined in: async-throttler.ts:95

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

---

### leading?

ts

optional leading: boolean;


optional leading: boolean;

Defined in: async-throttler.ts:100

Whether to execute the function immediately when called Defaults to true

---

### onError()?

ts

optional onError: (error, args, asyncThrottler) => void;


optional onError: (error, args, asyncThrottler) => void;

Defined in: async-throttler.ts:106

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

#### Parameters ##### error

Error

##### args

Parameters<TFn>

##### asyncThrottler

AsyncThrottler <TFn>

#### Returns

void

---

### onSettled()?

ts

optional onSettled: (args, asyncThrottler) => void;


optional onSettled: (args, asyncThrottler) => void;

Defined in: async-throttler.ts:114

Optional function to call when the throttled function is executed

#### Parameters ##### args

Parameters<TFn>

##### asyncThrottler

AsyncThrottler <TFn>

#### Returns

void

---

### onSuccess()?

ts

optional onSuccess: (result, args, asyncThrottler) => void;


optional onSuccess: (result, args, asyncThrottler) => void;

Defined in: async-throttler.ts:121

Optional function to call when the throttled function is executed

#### Parameters ##### result

ReturnType<TFn>

##### args

Parameters<TFn>

##### asyncThrottler

AsyncThrottler <TFn>

#### Returns

void

---

### throwOnError?

ts

optional throwOnError: boolean;


optional throwOnError: boolean;

Defined in: async-throttler.ts:131

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.

---

### trailing?

ts

optional trailing: boolean;


optional trailing: boolean;

Defined in: async-throttler.ts:136

Whether to execute the function on the trailing edge of the wait period Defaults to true

---

### wait

ts

wait: number | (throttler) => number;


wait: number | (throttler) => number;

Defined in: async-throttler.ts:142

Time window in milliseconds during which the function can only be executed once. Can be a number or a function that returns a number. Defaults to 0ms

Edit on GitHub

ThrottlerState

AsyncThrottlerState

Partners Become a Partner