示例

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