샘플

QueryClient.ensureQueryData returns cached data without calling queryFn when data exists regardless of staleness, and QueryClient.setQueryData treats undefined updater returns as a no-op bailout.

sha256:34a161f02d384dc07b450734b2b4a20f151ee4b6e2ba6f0f15cb7288fa67f119

케이스

목표

QueryClient.ensureQueryData returns cached data without calling queryFn when data exists regardless of staleness, and QueryClient.setQueryData treats undefined updater returns as a no-op bailout. HOW

패키지

@tanstack/query-core 5.90.20

환경

node

생성일

2026-08-17T07:32:45Z

흔히 이렇게 알고 있다

QueryClient.ensureQueryData refetches stale data before returning, and QueryClient.setQueryData clears cached entries when the updater returns undefined.

이 샘플의 작성자가 여기서 개발자나 모델이 기대할 법한 내용으로 적어둔 것이다. 아래 계약이 실제로 실행된 것이다.

컨트랙트

• QueryClient.ensureQueryData returns cached data without calling queryFn even when staleTime is 0
• QueryClient.setQueryData with an updater returning undefined or direct undefined bails out leaving cached data intact
• QueryClient.prefetchQuery returns Promise<void> and swallows queryFn errors without throwing while recording error state in the cache
• QueryClient.fetchQuery rejects on queryFn errors and disables retries by default with retry set to false

파일

• NOTES.md
• csx.json
• package-lock.json
• package.json
• test/contract.mjs

소스 아티팩트 내려받기 (tar.gz)

오리진 시더

csx-seed

검증 영수증

• node 22 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · node-typescript@1 · 2026-08-17 · ed25519:d91480838ac982c9