[vue-query] queryClient.fetchQuery passes getter options through without unwrapping

Aperta
#11,102 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@byungsker ci sta già lavorando.

Dal 22/7/2026.

  • #11103 di @byungsker — aperta
  • #11108 di @MaNaN1803 — chiusa senza merge

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
25/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
typescript

Direzione di ricerca

Inizia con l’implementazione di @tanstack/vue-query QueryClient.fetchQuery e la relativa chiamata a cloneDeepUnref. Esamina il test di regressione mirato collegato in PR #11103, quindi verifica che un oggetto di opzioni restituito da un getter venga valutato e decomposto prima di raggiungere query-core.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Describe the bug

QueryClient.fetchQuery in @tanstack/vue-query has an overload that accepts getter-function options, but the runtime implementation currently passes that top-level function through to query-core instead of evaluating it first.

The overload allows this shape:

queryClient.fetchQuery(() => ({
  queryKey: ["foo", ref("bar")],
  queryFn,
}))

But the implementation calls cloneDeepUnref(options) directly. cloneDeepUnref unwraps refs and nested query-key getters, but it does not call a top-level function value. As a result, query-core receives the function itself instead of the resolved FetchQueryOptions object.

Your minimal, reproducible example

Focused regression test in the linked PR: https://github.com/TanStack/query/pull/11103/files#diff-3d6cc18a7ff7e8e5afb08c0e3cba8d9f3e08fb9c6f6c59f1f5f58dc12f3f8b8e

Minimal code shape:

import { QueryClient } from "@tanstack/vue-query"
import { ref } from "vue"

const queryClient = new QueryClient()
const queryFn = () => Promise.resolve("mock")

queryClient.fetchQuery(() => ({
  queryKey: ["foo", ref("bar")],
  queryFn,
}))
Steps to reproduce
  1. Create a Vue Query QueryClient.
  2. Call queryClient.fetchQuery with a getter function returning FetchQueryOptions.
  3. Observe that the getter is not evaluated before delegating to query-core.

A focused test shows the current behavior clearly:

queryClient.fetchQuery(() => ({
  queryKey: queryKeyRef,
  queryFn: fn,
}))

expect(QueryClientOrigin.prototype.fetchQuery).toHaveBeenCalledWith({
  queryKey: queryKeyUnref,
  queryFn: fn,
})

Currently the received argument is [Function anonymous].

Expected behavior

queryClient.fetchQuery(() => options) should evaluate the top-level getter, then deep-unref the returned options object before passing it to query-core.

How often does this bug happen?

Every time

Screenshots or Videos

No response

Platform
  • OS: macOS
  • Browser: N/A
  • Runtime: Node.js v24.13.0
  • Adapter: vue-query
  • Vue runtimes tested: Vue 2 / Vue 2.7 / Vue 3
Tanstack Query adapter

vue-query

TanStack Query version

v5.101.4 / current main branch at commit 86bb8a6fb

TypeScript version

TypeScript 5.9.3 in the local repo; package type tests also passed across the repo's configured TS 5.4 through TS 6.0 matrix.

Additional context

I could not find an existing open issue or PR for this with these searches:

  • vue queryClient fetchQuery getter options cloneDeepUnref
  • fetchQuery getter function options vue-query
Lingua principale
TypeScript
Stelle
50.6k
Fork
4.2k
Merge medio
9h 50m
PR unite (30g)
310

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di TanStack/query

Tutte le issue di TanStack/query

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.