Skip to main content
Version: 4.xx.xx
Source Code

useInvalidate

useInvalidate is a hook that can be used to invalidate the state of a particular resource or dataProvider (with dataProviderName).

This hook will be called when a mutation hook is successful. For example, creating a Posts with the useCreate hook will invalidate the list (useList) and many (useMany) state of the Posts resource.

Good to know:
  • This hook is used internally by Refine. In most cases, you won't need this hook, but we export it as it may be useful for some use-cases that may require customized invalidation.
  • Refine uses TanStack Query to fetch and manage the state of the data. For more information about invalidation, please read the TanStack Query's invalidation docs.

Basic Usageโ€‹

import { useInvalidate } from "@refinedev/core";

const invalidate = useInvalidate();

// `invalidate` function is async and returns a promise. If you want to wait for the invalidation process to complete, you can await it.
invalidate({
resource: "posts",
invalidates: ["list"],
});

Examplesโ€‹

To invalidate the "list" and "many" states of the Posts resource.

invalidate({
resource: "posts",
invalidates: ["list", "many"],
});

To invalidate the state of a Posts with an id of 1.

invalidate({
resource: "posts",
invalidates: ["detail"],
id: 1,
});

To invalidate the "list" and "many" states of the Posts resource of the dataProvider named "second-data-provider".

invalidate({
resource: "posts",
dataProviderName: "second-data-provider",
invalidates: ["list"],
});

To invalidate all states of the dataProvider named "second-data-provider".

invalidate({
dataProviderName: "second-data-provider",
invalidates: ["all"],
});

To invalidate all states of the Posts.

invalidate({
resource: "posts",
invalidates: ["resourceAll"],
});

Invalidation Parametersโ€‹

resourceโ€‹

A resource represents an entity in an endpoint in the API (e.g. https://api.fake-rest.refine.dev/posts). It is used to invalidate the state of a particular resource.

idโ€‹

The id to use when invalidating the "detail" state.

dataProviderNameโ€‹

If there is more than one dataProvider, you should specify which one to use by passing the dataProviderName prop.

invalidates
required
โ€‹

The scope of the invalidation process. These scopes can be provided in an array.

  • "all": Invalidates all states of the all resources.
  • "resourceAll": Invalidates all states of the given resource.
  • "list": Invalidates the "list" state of the given resource.
  • "detail": Invalidates the "detail" state of the given resource and id.
  • "many": Invalidates the "many" state of the given resource.

invalidationFilters and invalidationOptionsโ€‹

The filters and options applied to the invalidation process when picking which queries to invalidate. By default Refine applies some filters and options to fine-tune the invalidation process.

By default settings, all the targeted queries are invalidated and the active ones are triggered for a refetch. If there are any ongoing queries, they are kept as they are.

API Referenceโ€‹

Invalidation Parametersโ€‹

PropertyDescriptionTypeDefault
invalidated
๏นก
The states you want to invalidate.all, resourceAll, list, many, detail, false
resourceResource name for State invalidation.string
idThe id to use when invalidating the "detail" state.BaseKey
dataProviderNameThe name of the data provider whose state you want to invalidate.stringdefault
invalidationFiltersThe filters to use when picking queries to invalidateInvalidateQueryFilters{ type: "all", refetchType: "active" }
invalidationOptionsThe options to use in the invalidation processInvalidateOptions{ cancelRefetch: false }