setQueriesData(...)
The synchronous function that can be used to immediately update cached data of multiple queries by using filter. Only queries that match the passed QueryKey will be updated. No new cache entries will be created. See the TanStack queryClient.setQueriesData ๐ด documentation.
- Without
options
- With
options
const data = qraft.<service>.<operation>.setQueriesData(
filters,
updater
);
Argumentsโ
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 parametersfilters.infinite: boolean
will be used to filter infinite or normal queriesfilters.queryKey: QueryKey
will be used for filtering queries by QueryKey instead of parametersfilters.queryKey
andfilters.parameters
are mutually exclusive
filters.predicate?: (query: Query) => boolean
will be used for filtering queries by custom predicate
updater: TData | (oldData: TData | undefined) => TData | undefined
- Required updater to be used to set the data in the Query Cache
const data = qraft.<service>.<operation>.setQueriesData(
filters,
updater,
options
);
Argumentsโ
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 parametersfilters.infinite: boolean
will be used to filter infinite or normal queriesfilters.queryKey: QueryKey
will be used for filtering queries by QueryKey instead of parametersfilters.queryKey
andfilters.parameters
are mutually exclusive
filters.predicate?: (query: Query) => boolean
will be used for filtering queries by custom predicate
updater: TData | (oldData: TData | undefined) => TData | undefined
- Required updater to be used to set the data in the Query Cache
options: SetQueryDataOptions
- Required options to set the data in the cache
- See the TanStack queryClient.setQueriesData ๐ด documentation.
Returnsโ
Array<TData | undefined>
- The data that was set in the cache.
Exampleโ
- Without
options
- With
options
- With
QueryKey
const parameters = { path: { petId: 123 } };
qraft.pet.getPetById.setQueriesData(
{ parameters, infinite: false },
{ id: 123, name: 'Rex' }
);
const pet = qraft.pet.getPetById.getQueryData(parameters);
expect(pet).toEqual({
id: 123,
name: 'Rex',
});
const pets = qraft.pet.getPetById.setQueriesData(
{ parameters: { path: { petId: 123 } }, infinite: false },
{ id: 123, name: 'Rex' },
{ updatedAt: Date.now() - 60_000 }
);
It's also possible to use a QueryKey
as an array instead of an object with {path, query, header}
:
const pets = qraft.pet.getPetById.setQueriesData(
{
queryKey: [
{ method: 'get', url: '/pet/{petId}', infinite: false },
{ petId: 123 },
],
},
{ id: 123, name: 'Rex' }
);