API

const { data, error, isLoading, isValidating, mutate } = useSWR(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 useSWR

Valores devueltos#

• data: data de la key dada resueltos por el fetcher (o undefined si no está cargado)
• error: error lanzado por el fetcher (o undefined)
• isLoading: if there's an ongoing request and no "loaded data". Fallback data and previous data are not considered "loaded data"
• isValidating: si hay una solicitud o carga de revalidación
• mutate(data?, options?: función para mutar los datos en caché (detalles)

More information can be found here.

Opciones#

• suspense = false: activar el modo React Suspense (detalles)
• fetcher(args): la fetcher función
• revalidateIfStale = true: automatically revalidate even if there is stale data (details)
• revalidateOnMount: activar o desactivar la revalidación automática cuando se monta el componente
• 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 de navigator.onLine) (detalles)
• refreshInterval (detalles):
  • desactivado por defecto: refreshInterval = 0
  • If set to a number, polling interval
  • If set to a function, the function will receive the latest data and should return the interval in milliseconds
• refreshWhenHidden = false: polling cuando window es invisible (si refreshInterval está activado)
• refreshWhenOffline = false: polling cuando el navegador está desconectado (determinado por navigator.onLine)
• shouldRetryOnError = true: reitentar cuando el fetcher tiene un error
• dedupingInterval = 2000: solicitudes de deduplicación con la misma key en este lapso de tiempo
• focusThrottleInterval = 5000: sólo revalidar una vez durante un periodo de tiempo
• loadingTimeout = 3000: tiempo de espera para activar el evento onLoadingSlow
• errorRetryInterval = 5000: error retry interval
• errorRetryCount: número máximo de reintentos de error
• fallback: a key-value object of multiple fallback data (example)
• fallbackData: datos iniciales a devolver (nota: Esto es por un hook)
• keepPreviousData = false: return the previous key's data until the new data has been loaded (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 éxito
• onError(err, key, config): función callback cuando una petición devuelve un error
• onErrorRetry(err, key, config, revalidate, revalidateOps): manejador para el reintento de error
• onDiscarded(key): callback function when a request is ignored due to race conditions
• compare(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.
• isPaused(): para detectar si pause revalidations, ignorará los datos obtenidos y los errores cuando devuelva true. Devuelve false por defecto.
• use: array of middleware functions (details)

También puede utilizar la configuración global para proporcionar opciónes por defecto.