tanstack-query

TanStack Query

クエリ、ミューテーション、キャッシュ、楽観的更新、SSR、永続化、テスト、すべての公式アダプターに関するサーバー状態のガイダンスです。

まず、リリースに対応したアダプターのドキュメントを確認してください。Query Intent のドラフトガイダンスは別途保存されています。インストール済みのバージョンと照らし合わせて確認してください。

ワークフロー

1. インストール済みの TanStack パッケージと正確なバージョンを確認します。
2. インストール済みアダプターのインデックス、または以下の一般的なタスクを開きます。ドラフトのタスクガイドは、API をリリースに対応したアダプターと照らし合わせて確認したうえで、補足ガイダンスとして使用します。
3. トピックリファレンスはインデックスです。タスクに適したガイドまたはセクションを選び、必要な場合にのみ前提条件へのリンクをたどります。
4. 記憶よりも、インストール済みパッケージの型とバージョンに対応したソースガイダンスを優先します。
5. 例をフレームワークアダプター向けに翻訳する際は、ヘッドレス／コアの動作を維持します。

タスクの振り分け

• React アダプター — リリースに対応した React のセットアップ、クエリ、リアクティビティ。
• Preact アダプター — リリースに対応した Preact のセットアップ、クエリ、リアクティビティ。
• Vue アダプター — リリースに対応した Vue のセットアップ、クエリ、リアクティビティ。
• Solid アダプター — リリースに対応した Solid のセットアップ、クエリ、リアクティビティ。
• Svelte アダプター — リリースに対応した Svelte のセットアップ、クエリ、リアクティビティ。
• Angular アダプター — リリースに対応した Angular のセットアップ、クエリ、リアクティビティ。
• Lit アダプター — リリースに対応した Lit のセットアップ、クエリ、リアクティビティ。
• 基礎 — クライアントのセットアップ、キー、オプション、フェッチ、デフォルト、抽象化。
• ミューテーションとキャッシュ更新 — ミューテーション、無効化、キャンセル、楽観的更新。
• データ整形 — ページネーション、無限クエリ、プレースホルダー、セレクター、レンダリング効率。
• フレームワークと UI 状態 — アダプターのリアクティビティ、ステータス、エラー、サスペンス、開発者ツール。
• ルーティングと SSR — ルーターの構成、プリフェッチ、ハイドレーション、ストリーミング。
• オフラインとインテグレーション — 永続化、ブロードキャスト、リアルタイム、フォーム連携。
• 品質と移行 — リントルール、テスト、メジャーバージョンの移行。

一般的なタスク

• React：楽観的更新とロールバック
• Vue：リアクティブな入力値の変更時に再フェッチする

フレームワークの振り分け

• React — @tanstack/react-query を検出します。React アダプターを参照してください。
• Preact — @tanstack/preact-query を検出します。Preact アダプターを参照してください。
• Vue — @tanstack/vue-query を検出します。Vue アダプターを参照してください。
• Solid — @tanstack/solid-query を検出します。Solid アダプターを参照してください。
• Svelte — @tanstack/svelte-query を検出します。Svelte アダプターを参照してください。
• Angular — @tanstack/angular-query-experimental を検出します。Angular アダプターを参照してください。
• Lit — @tanstack/lit-query を検出します。Lit アダプターを参照してください。

アダプターのバージョンは各ガイドに記載されています。特に、Svelte と Lit では Query Core とは異なるメジャーバージョンが使われている場合があります。ドラフトのタスク例は、別のアダプターにその API が存在する根拠にはなりません。

製品の境界

タスクが以下の製品の境界をまたぐ場合は、それぞれの製品スキルを使用してください：tanstack-router、tanstack-start、tanstack-form。

ソースのステータス

TanStack/query の公式ドキュメントです。次の確認済みリリース入力に対応しています：@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]、@tanstack/[email protected]。

正確な上流入力と重複排除の記録については、ソースの来歴をご覧ください。