katanakit-js / TimeoutManager

Interface: TimeoutManager

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:47

Allows customization of how timeouts are created.

@tanstack/query-core makes liberal use of timeouts to implement staleTime and gcTime. The default TimeoutManager provider uses the platform's global setTimeout implementation, which is known to have scalability issues with thousands of timeouts on the event loop.

If you hit this limitation, consider providing a custom TimeoutProvider that coalesces timeouts.

Implements

• Omit<TimeoutProvider, "name">

Methods

clearInterval()

clearInterval(intervalId): void;

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:149

clearInterval can be used to cancel an interval, like the global clearInterval function. It should be called with an interval ID returned by setInterval.

Parameters

Parameter	Type
intervalId	ManagedTimerId | undefined

Returns

void

Example

import { timeoutManager } from '@tanstack/query-core'

const intervalId = timeoutManager.setInterval(
  () => console.log('ran at:', new Date()),
  1000,
)

timeoutManager.clearInterval(intervalId)

Implementation of

Omit.clearInterval

---

clearTimeout()

clearTimeout(timeoutId): void;

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:113

clearTimeout cancels a timeout callback scheduled with setTimeout, like the global clearTimeout function. It should be called with a timer ID returned by setTimeout.

Parameters

Parameter	Type
timeoutId	ManagedTimerId | undefined

Returns

void

Example

import { timeoutManager } from '@tanstack/query-core'

const timeoutId = timeoutManager.setTimeout(
  () => console.log('ran at:', new Date()),
  1000,
)

timeoutManager.clearTimeout(timeoutId)

Implementation of

Omit.clearTimeout

---

setInterval()

setInterval(callback, delay): ManagedTimerId;

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:131

setInterval schedules a callback to be called approximately every delay milliseconds, like the global setInterval function.

Like setTimeout, it returns a timer ID, which may be a number or an object that can be coerced to a number via Symbol.toPrimitive.

Parameters

Parameter	Type
callback	TimeoutCallback
delay	number

Returns

ManagedTimerId

Example

import { timeoutManager } from '@tanstack/query-core'

const intervalId = timeoutManager.setInterval(
  () => console.log('ran at:', new Date()),
  1000,
)

Implementation of

Omit.setInterval

---

setTimeout()

setTimeout(callback, delay): ManagedTimerId;

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:95

setTimeout schedules a callback to run after approximately delay milliseconds, like the global setTimeout function. The callback can be canceled with clearTimeout.

It returns a timer ID, which may be a number or an object that can be coerced to a number via Symbol.toPrimitive.

Parameters

Parameter	Type
callback	TimeoutCallback
delay	number

Returns

ManagedTimerId

Example

import { timeoutManager } from '@tanstack/query-core'

const timeoutId = timeoutManager.setTimeout(
  () => console.log('ran at:', new Date()),
  1000,
)

const timeoutIdNumber: number = Number(timeoutId)

Implementation of

Omit.setTimeout

---

setTimeoutProvider()

setTimeoutProvider<TTimerId>(provider): void;

Defined in: node_modules/.bun/@tanstack+query-core@5.104.1/node_modules/@tanstack/query-core/build/modern/timeoutManager.d.ts:74

setTimeoutProvider can be used to set a custom implementation of the setTimeout, clearTimeout, setInterval, clearInterval functions, called a TimeoutProvider.

This may be useful if you notice event loop performance issues with thousands of queries. A custom TimeoutProvider could also support timer delays longer than the global setTimeout maximum delay value of about 24 days.

It is important to call setTimeoutProvider before creating a QueryClient or queries, so that the same provider is used consistently for all timers in the application, since different TimeoutProviders cannot cancel each others' timers.

Type Parameters

Type Parameter
TTimerId extends ManagedTimerId

Parameters

Parameter	Type
provider	TimeoutProvider<TTimerId>

Returns

void

Example

import { timeoutManager, QueryClient } from '@tanstack/query-core'
import { CustomTimeoutProvider } from './CustomTimeoutProvider'

timeoutManager.setTimeoutProvider(new CustomTimeoutProvider())

export const queryClient = new QueryClient()