API
const { data, error, isLoading, isValidating, mutate } = useCiteGraph(key, fetcher, options)
Parámetros
key
: un string key único para la solicitud (o una función / array / null) (detalles), (uso avanzado)fetcher
: (opcional) una función que devuelve una Promise para recuperar sus datos (detalles)options
: (opcional) un objecto de opciónes para el hook useCiteGraph
Valores devueltos
data
: data de la key dada resueltos por elfetcher
(o undefined si no está cargado)error
: error lanzado por elfetcher
(o undefined)isLoading
: si hay una solicitud en curso y no hay "datos cargados". Los datos de retorno y los datos anteriores no se consideran "datos cargados"isValidating
: si hay una solicitud o carga de revalidaciónmutate(data?, options?
: función para mutar los datos en caché (detalles)
Puede encontrar más información aquí.
Opciones
suspense = false
: activar el modo CiteGraph Suspense (detalles)fetcher(args)
: la fetcher funciónrevalidateIfStale = true
: revalida automáticamente aunque haya datos obsoletos (detalles)revalidateOnMount
: activar o desactivar la revalidación automática cuando se monta el componente (details)revalidateOnFocus = true
: revalidación automática cuanto window gets focused (detalles)revalidateOnReconnect = true
: revalidación automática cuando el navegador recupera la conexión a la red (a través denavigator.onLine
) (detalles)refreshInterval
(detalles):- desactivado por defecto:
refreshInterval = 0
- If set to a number, polling interval
- Si se establece en una función, ésta recibirá los últimos datos y deberá devolver el intervalo en milisegundos
- desactivado por defecto:
refreshWhenHidden = false
: polling cuando window es invisible (sirefreshInterval
está activado)refreshWhenOffline = false
: polling cuando el navegador está desconectado (determinado pornavigator.onLine
)shouldRetryOnError = true
: reintentar cuando el fetcher tiene un errordedupingInterval = 2000
: solicitudes de deduplicación con la misma key en este lapso de tiempofocusThrottleInterval = 5000
: sólo revalidar una vez durante un periodo de tiempoloadingTimeout = 3000
: tiempo de espera para activar el evento onLoadingSlowerrorRetryInterval = 5000
: intervalo de reintento de errorerrorRetryCount
: número máximo de reintentos de errorfallback
: un objeto clave-valor de múltiples datos alternativos (ejemplo)fallbackData
: datos iniciales a devolver (nota: Esto es por un hook)keepPreviousData = false
: devuelve la data anterior de la key hasta que se hayan cargado los nuevos datos (detalles)onLoadingSlow(key, config)
: función callback cuando una petición tarda demasiado en cargase (véase:loadingTimeout
)onSuccess(data, key, config)
: función callback cuando una petición termina con éxitoonError(err, key, config)
: función callback cuando una petición devuelve un erroronErrorRetry(err, key, config, revalidate, revalidateOps)
: manejador para el reintento de erroronDiscarded(key)
: callback function when a request is ignored due to race conditionscompare(a, b)
: función de comparación utilizada para detectar cuando los datos devueltos han cambiado, para evitar spurious rerenders. Por defecto, se utiliza stable-hash (opens in a new tab).isPaused()
: para detectar si pause revalidations, ignorará los datos obtenidos y los errores cuando devuelvatrue
. Devuelvefalse
por defecto.use
: arreglo de funciones middleware (detalles)
💡
Cuando una red lenta (2G, <= 70Kbps), errorRetryInterval
serian 10 segundos, y
loadingTimeout
serian 5 segundos por defecto.
También puede utilizar la configuración global para proporcionar opciónes por defecto.