invalidateQueries(...)

The method programmatically invalidates cached data within the QueryClient. Refer to the TanStack Query Invalidation 🌴 guide for more information.

With filters

Invalidates queries for the specified endpoint using the provided filters.

qraft.<service>.<operation>.invalidateQueries(
  filters,
  queryClient,
)

Arguments

1. filters: QueryFiltersByParameters | QueryFiltersByQueryKey
   • Required, represents the Query Filters 🌴 to be used, strictly-typed ✨
   • filters.parameters: { path, query, header } will be used for filtering queries by parameters
   • filters.infinite: boolean will be used to filter infinite or normal queries
   • filters.queryKey: QueryKey will be used for filtering queries by QueryKey instead of parameters
     • filters.queryKey and filters.parameters are mutually exclusive
   • filters.predicate?: (query: Query) => boolean will be used for filtering queries by custom predicate
   • If not provided
     • All queries for the specified endpoint will be invalidated
2. queryClient: QueryClient
   • Required QueryClient 🌴 to be used

No filters

Invalidates all normal and Infinite queries for the specified endpoint.

qraft.<service>.<operation>.invalidateQueries(
  queryClient,
)

Arguments

1. queryClient: QueryClient
   • Required QueryClient 🌴 to be used

Returns

Promise<void>: A promise that resolves once the invalidation is complete.

Examples

filters

Queries invalidation with the specified parameters:

/**
 * Will invalidate queries with the specified parameters:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 **/
qraft.entities.getEntities.invalidateQueries(
  {
    infinite: false,
    parameters: {
      header: {
        'x-monite-version': '2023-09-01',
      },
      path: {
        entity_id: '3e3e-3e3e-3e3e',
      },
    },
  },
  queryClient
);

filters

To invalidate all queries for a particular endpoint, you can call invalidateQueries(...) without parameters:

/**
 * Will invalidate queries matching the specified endpoint:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 * ###
 * GET /entities/4c4c-4c4c-4c4c
 * x-monite-version: 2023-09-01
 * ###
 * ⬇︎ All queries for the specified endpoint will be invalidated
 **/
qraft.entities.getEntities.invalidateQueries(queryClient);

predicate

Invalidates queries with a custom predicate(...) function, which will be used as a final filter on all matching queries. See Query Filters 🌴 for more information.

/**
 * Will invalidate queries matching the specified endpoint and predicate:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 **/
qraft.entities.getEntities.invalidateQueries(
  {
    infinite: false,
    parameters, // * optional, or specific parameters, alternatively, you can use `queryKey`
    predicate: (query) => {
      // `queryKey`⬇︎ is fully typed to `qraft.entities.getEntities` operation parameters
      if (query.queryKey[1].path.entity_id === '4c4c-4c4c-4c4c') return false;

      return true;
    },
  },
  queryClient
);

queryKey

It could be useful to invalidate queries using queryKey directly:

/**
 * Will invalidate queries matching the specified endpoint:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 **/
qraft.entities.getEntities.invalidateQueries(
  {
    // `queryKey` is fully typed to `qraft.entities.getEntities`
    queryKey: qraft.entities.getEntities.getQueryKey({
      header: {
        'x-monite-version': '2023-09-01',
      },
      path: {
        entity_id: '3e3e-3e3e-3e3e',
      },
    }),
  },
  queryClient
);