cancelQueries(...)

The method can be used to cancel outgoing queries. Refer to the TanStack queryClient.cancelQueries 🌴 and Query Cancellation 🌴 guide for more information.

With filters, options

Cancels queries for the specified endpoint using the provided filters.

qraft.<service>.<operation>.cancelQueries(
  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 canceled
2. queryClient: QueryClient
   • Required QueryClient 🌴 to be used

With filters, options

Cancels queries for the specified endpoint using the provided filters with the specified options.

qraft.<service>.<operation>.cancelQueries(
  filters,
  options,
  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 canceled
2. options: CancelOptions
   • Required CancelOptions 🌴 to be used
3. queryClient: QueryClient
   • Required QueryClient 🌴 to be used

No filters, options

Cancels all normal and Infinite queries for the specified endpoint.

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

Arguments

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

Returns

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

Examples

filters

Queries cancellation with the specified parameters:

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

filters

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

/**
 * Will cancel 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 canceled
 **/
qraft.entities.getEntities.cancelQueries(queryClient);

predicate

Cancels 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 cancel queries matching the specified endpoint and predicate:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 **/
qraft.entities.getEntities.cancelQueries(
  {
    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 cancel queries using queryKey directly:

/**
 * Will cancel queries matching the specified endpoint:
 * ###
 * GET /entities/3e3e-3e3e-3e3e
 * x-monite-version: 2023-09-01
 **/
qraft.entities.getEntities.cancelQueries(
  {
    // `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
);