Defined in: async-debouncer.ts:73

A class that creates an async debounced function.

Debouncing ensures that a function is only executed after a specified delay has passed since its last invocation. Each new invocation resets the delay timer. This is useful for handling frequent events like window resizing or input changes where you only want to execute the handler after the events have stopped occurring.

Unlike throttling which allows execution at regular intervals, debouncing prevents any execution until the function stops being called for the specified delay period.

const asyncDebouncer = new AsyncDebouncer(async (value: string) => {
  await searchAPI(value);
}, { wait: 500 });

// Called on each keystroke but only executes after 500ms of no typing
inputElement.addEventListener('input', () => {
  asyncDebouncer.maybeExecute(inputElement.value);
});

const asyncDebouncer = new AsyncDebouncer(async (value: string) => {
  await searchAPI(value);
}, { wait: 500 });

// Called on each keystroke but only executes after 500ms of no typing
inputElement.addEventListener('input', () => {
  asyncDebouncer.maybeExecute(inputElement.value);
});

• TFn extends AnyAsyncFunction

new AsyncDebouncer<TFn>(fn, initialOptions): AsyncDebouncer<TFn>

new AsyncDebouncer<TFn>(fn, initialOptions): AsyncDebouncer<TFn>

Defined in: async-debouncer.ts:86

TFn

AsyncDebouncerOptions<TFn>

AsyncDebouncer<TFn>

cancel(): void

cancel(): void

Defined in: async-debouncer.ts:195

Cancels any pending execution or aborts any execution in progress

void

getErrorCount(): number

getErrorCount(): number

Defined in: async-debouncer.ts:224

Returns the number of times the function has errored

number

getIsExecuting(): boolean

getIsExecuting(): boolean

Defined in: async-debouncer.ts:238

Returns true if there is currently an execution in progress

boolean

getIsPending(): boolean

getIsPending(): boolean

Defined in: async-debouncer.ts:231

Returns true if there is a pending execution queued up for trailing execution

boolean

getLastResult(): undefined | ReturnType<TFn>

getLastResult(): undefined | ReturnType<TFn>

Defined in: async-debouncer.ts:203

Returns the last result of the debounced function

undefined | ReturnType<TFn>

getOptions(): Required<AsyncDebouncerOptions<TFn>>

getOptions(): Required<AsyncDebouncerOptions<TFn>>

Defined in: async-debouncer.ts:112

Returns the current debouncer options

Required<AsyncDebouncerOptions<TFn>>

getSettleCount(): number

getSettleCount(): number

Defined in: async-debouncer.ts:217

Returns the number of times the function has settled (completed or errored)

number

getSuccessCount(): number

getSuccessCount(): number

Defined in: async-debouncer.ts:210

Returns the number of times the function has been executed successfully

number

maybeExecute(...args): Promise<undefined | ReturnType<TFn>>

maybeExecute(...args): Promise<undefined | ReturnType<TFn>>

Defined in: async-debouncer.ts:120

Attempts to execute the debounced function If a call is already in progress, it will be queued

...Parameters<TFn>

Promise<undefined | ReturnType<TFn>>

setOptions(newOptions): void

setOptions(newOptions): void

Defined in: async-debouncer.ts:100

Updates the debouncer options Returns the new options state

Partial<AsyncDebouncerOptions<TFn>>

void