SwrContext

SwrContext is a React context used by the SWR data fetching library to propagate configuration options through a component tree. It allows a component subtree to share default behavior for data fetching and revalidation, and it can be overridden for a sub-tree by a configuration provider.

SwrContext works by storing a configuration object that SWR hooks consult to determine default values for fetcher, deduping interval, revalidation behavior, and error handling. When a component calls the SWR hook, its per-call options are merged with the values from SwrContext, with the per-call options taking precedence over the context values.

Common options associated with SwrContext include the fetcher function, dedupingInterval, revalidateOnFocus, revalidateOnReconnect, refreshInterval, shouldRetryOnError, errorRetryCount, and callbacks such as onError or onSuccess. These options can be provided through the context and overridden by per-hook calls.

SWRConfigProvider is the standard mechanism to set global defaults by supplying a value object to SwrContext for a subtree. This enables consistent behavior across many components, while still allowing individual components to override specific options when needed.

In practical use, wrapping a subtree with SWRConfigProvider establishes a shared configuration for nested components. Internally, the SwrContext is read by SWR hooks, and developers typically interact with the related API surface through useSWR with per-call options or through useSWRConfig for mutating the global config.