Skip to content

API Documentation / @pinia/colada / useQuery

Function: useQuery()

ts
function useQuery<TData, TError, TDataInitial>(options): UseQueryReturn<TData, TError, TDataInitial>;

Ensures and return a shared query state based on the key option.

Type Parameters

TData

TData

TError

TError = { custom: Error; }

TDataInitial

TDataInitial = undefined

Parameters

options

The options of the query

UseQueryOptions<TData, TError, TDataInitial> | () => DefineQueryOptions<TData, TError, TDataInitial>

Returns

UseQueryReturn<TData, TError, TDataInitial>

Example

ts
const { state } = useQuery({
  key: ['documents'],
  query: () => getDocuments(),
})

Released under the MIT License.