🇺🇸English

TanStack/query @tanstack/vue-query

Hooks for managing, caching and syncing asynchronous and remote data in Vue

Version: 5.95.2 Deps: @tanstack/match-sorter-utils@^8.19.4, @vue/devtools-api@^6.6.3, vue-demi@^0.14.10, @tanstack/query-core@5.95.2 Tags: alpha: 5.0.0-alpha.91, beta: 5.0.0-beta.35, rc: 5.0.0-rc.16, previous: 4.43.0, latest: 5.95.2

References: Docs — API reference, guides

API Changes

This section documents version-specific API changes — prioritize recent major/minor releases.

• BREAKING: useQuery signature — v5 requires a single object argument { queryKey, queryFn, ... }. Old positional arguments are no longer supported and will result in errors source

• BREAKING: useQueries signature — v5 now takes an object with a queries array property: useQueries({ queries: [...] }). This allows for additional top-level options like combine

• BREAKING: useQueries return type — now returns a Ref of the results array instead of a reactive array, ensuring better compatibility with Vue 2 and avoiding spread reactivity loss source

• BREAKING: Callback removal — onSuccess, onError, and onSettled are removed from useQuery, useInfiniteQuery, and useQueries. Use select for data transformation or global QueryCache callbacks instead source

• BREAKING: cacheTime renamed — renamed to gcTime (Garbage Collection time) across all options and default options to better reflect its purpose source

• BREAKING: useInfiniteQuery parameters — getNextPageParam and getPreviousPageParam now receive a single object containing lastPage, allPages, lastPageParam, and allPageParams source

• BREAKING: keepPreviousData removed — the option is replaced by the placeholderData: keepPreviousData helper function from @tanstack/vue-query source

• NEW: queryOptions / infiniteQueryOptions — helper functions for sharing query definitions with type safety across components and for prefetching source

• NEW: useMutationState — new composable to access mutation state globally by filtering for specific mutations based on keys or filters

• NEW: Options Getter support — useQuery and useInfiniteQuery now support passing a getter function (e.g., () => options) or a Ref for the entire options object, enabling easier reactivity

• NEW: combine for useQueries — allows merging multiple query results into a single value (e.g., a single object or a derived state) via the combine option

• NEW: Injection Context — vue-query composables can now be used in any function that supports injectionContext (e.g., router guards) if used within an effectScope source

• DEPRECATED: isLoading — renamed to isPending in v5. The isLoading property now specifically means isPending && isFetching (fetching for the first time) source

• BREAKING: Vue 3.3 requirement — minimum Vue version for @tanstack/vue-query v5 is now 3.3 to support newer reactivity features source

Also changed: isPlaceholderData boolean result new v5 · initialPageParam required for useInfiniteQuery · isPaused property added to query results · Suspense (experimental) supported via suspense() method (experimental)

Best Practices

• Use MaybeRefOrGetter for composable parameters to support refs, plain values, and reactive getters seamlessly source

  // Preferred: Accepts ref, getter, or value export function useUser(id: MaybeRefOrGetter<string>) { return useQuery({ queryKey: ['user', id], queryFn: () => fetchUser(toValue(id)) }) }

• Pass the entire options object as a getter function to reactively update multiple query parameters at once (v5.91.0+) source

  // Preferred for complex reactivity useQuery(() => ({ queryKey: ['todo', id.value], queryFn: () => fetchTodo(id.value), enabled: !!id.value }))

• Prefer reactive getters over computed for simple property access to avoid unnecessary memoization overhead source

  // Preferred: No computed needed const { data } = useUserProjects(() => props.userId)

  // Avoid: Unnecessary memoization const userId = computed(() => props.userId) const { data } = useUserProjects(userId)

• Use onServerPrefetch with the suspense() helper to ensure queries are awaited during SSR

Weekly Installs

68

Repository

harlan-zw/vue-e…m-skills

GitHub Stars

147

First Seen

Feb 19, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

github-copilot56

opencode55

codex53

gemini-cli52

amp52

kimi-cli52