Skip to main content
Version: 4.5

useInvalidator()

function useInvalidator(
fetchShape: ReadShape,
): (params: object | null) => void;
function useInvalidator<Params extends Readonly<object>, S extends Schema>(
fetchShape: ReadShape<S, Params>,
): (params: Params | null) => void;

Mostly useful for imperatively invalidating the cache, with a similar signature to useFetcher.

Sending a null to params results in a no-op.

When used in conjunction with invalidIfStale it can force a component to re-suspend even if it has already fetched the data. Normally useResource will not suspend if the data is in the cache, even if it is stale. By pairing this option with useInvalidator the component will act as though it has never tried to fetch the resource before and trigger a fetch with suspense.

Example

import { Resource, FetchOptions } from 'rest-hooks';

export default class ArticleResource extends Resource {
readonly id: string = null;
readonly title: string = '';
// ...

/** Used as default options for every FetchShape */
static getFetchOptions(): FetchOptions {
return {
invalidIfStale: true,
};
}
}
// Invalidate cache on unmount. When component is remounted it will re-fetch
function useInvalidateOnUnmount<
Params extends Readonly<object>,
S extends Schema
>(fetchShape: ReadShape<S, Params>, params: Params | null) {
const invalidate = useInvalidator(fetchShape);

useEffect(() => {
return () => invalidate(params);
}, []);
}
function ArticleName({ id }: { id: string }) {
const asset = useResource(ArticleResource.detailShape(), { id });
useInvalidateOnUnmount(ArticleResource.detailShape(), { id });

return (
<div>
<h1>{article.title}<h1>
</div>
);
}