NotifyManager

notifyManager는 TanStack Query에서 콜백의 스케줄링과 일괄 처리를 담당합니다.

다음 메서드를 제공합니다:

• 일괄 처리
• batchCalls
• schedule
• setNotifyFunction
• setBatchNotifyFunction
• setScheduler

notifyManager.batch

batch를 사용하여 전달된 콜백 내부에서 예약된 모든 업데이트를 일괄 처리할 수 있습니다. 이는 주로 내부적으로 queryClient 업데이트를 최적화하는 데 사용됩니다.

function batch<T>(callback: () => T): T

notifyManager.batchCalls

batchCalls는 콜백을 받아 래핑하는 고차 함수입니다. 래핑된 함수를 호출할 때마다 다음 배치에서 콜백이 실행되도록 예약합니다.

type BatchCallsCallback<T extends Array<unknown>> = (...args: T) => void

function batchCalls<T extends Array<unknown>>(
  callback: BatchCallsCallback<T>,
): BatchCallsCallback<T>

notifyManager.schedule

schedule은 다음 배치에서 함수가 실행되도록 예약합니다. 기본적으로 배치는 다음과 같이 실행됩니다 setTimeout을 사용하지만 이를 구성할 수 있습니다.

function schedule(callback: () => void): void

notifyManager.setNotifyFunction

setNotifyFunction은 알림 함수를 재정의합니다. 이 함수에는 다음이 전달됩니다 콜백이 실행되어야 할 때 호출합니다. 기본 notifyFunction은 콜백을 호출하기만 합니다.

예를 들어 테스트를 실행하는 동안 알림을 React.act로 래핑하는 데 사용할 수 있습니다:

import { notifyManager } from '@tanstack/react-query'
import { act } from 'react-dom/test-utils'

notifyManager.setNotifyFunction(act)

notifyManager.setBatchNotifyFunction

setBatchNotifyFunction은 일괄 업데이트에 사용할 함수를 설정합니다

프레임워크에서 사용자 정의 일괄 처리 함수를 지원하는 경우 notifyManager.setBatchNotifyFunction을 호출하여 이를 TanStack Query에 알릴 수 있습니다.

예를 들어 solid-query에서는 다음과 같이 배치 함수를 설정합니다:

import { notifyManager } from '@tanstack/query-core'
import { batch } from 'solid-js'

notifyManager.setBatchNotifyFunction(batch)

notifyManager.setScheduler

setScheduler는 다음 시점을 예약해야 하는 사용자 지정 콜백을 구성합니다 배치가 실행됩니다. 기본 동작은 setTimeout(callback, 0)입니다.

import { notifyManager } from '@tanstack/react-query'

// Schedule batches in the next microtask
notifyManager.setScheduler(queueMicrotask)

// Schedule batches before the next frame is rendered
notifyManager.setScheduler(requestAnimationFrame)

// Schedule batches some time in the future
notifyManager.setScheduler((cb) => setTimeout(cb, 10))