OnlineManager

Defined in: packages/query-core/src/onlineManager.ts:15

The OnlineManager manages the online state within TanStack Query. It can be used to change the default event listeners or to manually change the online state.

By default, the onlineManager assumes an active network connection, and listens to the online and offline events on the window object to detect changes.

Extends#

• Subscribable<Listener>

Properties#

Methods#

hasListeners()#

hasListeners(): boolean;

Defined in: packages/query-core/src/subscribable.ts:41

Returns true while at least one listener is registered, false once they have all unsubscribed.

Returns#

boolean

Inherited from#

Subscribable.hasListeners

isOnline()#

isOnline(): boolean;

Defined in: packages/query-core/src/onlineManager.ts:109

isOnline can be used to get the current online state.

Returns#

boolean

onSubscribe()#

protected onSubscribe(): void;

Defined in: packages/query-core/src/onlineManager.ts:44

Returns#

void

Overrides#

Subscribable.onSubscribe

onUnsubscribe()#

protected onUnsubscribe(): void;

Defined in: packages/query-core/src/onlineManager.ts:50

Returns#

void

Overrides#

Subscribable.onUnsubscribe

setEventListener()#

setEventListener(setup: SetupFn): void;

Defined in: packages/query-core/src/onlineManager.ts:75

setEventListener can be used to set a custom event listener that will be used to determine the online state. The provided setup function receives a setOnline callback that should be called with a boolean whenever the online state changes.

Parameters#

setup#

SetupFn

Returns#

void

Example#

import NetInfo from '@react-native-community/netinfo'
import { onlineManager } from '@tanstack/query-core'

onlineManager.setEventListener((setOnline) => {
  return NetInfo.addEventListener((state) => {
    setOnline(!!state.isConnected)
  })
})

setOnline()#

setOnline(online: boolean): void;

Defined in: packages/query-core/src/onlineManager.ts:95

setOnline can be used to manually set the online state.

Parameters#

online#

boolean

Returns#

void

Example#

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

// Set to online
onlineManager.setOnline(true)

// Set to offline
onlineManager.setOnline(false)

subscribe()#

subscribe(listener: Listener): () => void;

Defined in: packages/query-core/src/subscribable.ts:27

Registers a listener to be called on every update this object notifies about. Returns a function that removes the listener again — call it to stop listening. The base class never drops a listener on its own, though some subclasses clear all of theirs in destroy().

Parameters#

listener#

Listener

Called on each update, with whatever the subclass passes to its subscribers.

Returns#

(): void;

Returns#

void

Example#

const unsubscribe = subscribable.subscribe(() => {
  // react to the update
})

unsubscribe()

Inherited from#

Subscribable.subscribe