サンプル

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