查询函数
查询函数可以是返回 Promise 的任意函数。该 Promise 应当要么解析出数据，要么抛出错误。
成功时，解析值可以是除 undefined 以外的任何值。解析为 undefined 的查询将被视为失败。若要在查询缓存中将“空值”作为成功结果存储，请改用解析 null。
以下所有写法均为有效的查询函数配置：
TypeScript
1useQuery({ queryKey: ['todos'], queryFn: fetchAllTodos })2useQuery({ queryKey: ['todos', todoId], queryFn: () => fetchTodoById(todoId) })3useQuery({4 queryKey: ['todos', todoId],5 queryFn: async () => {6 const data = await fetchTodoById(todoId)7 return data8 },9})10useQuery({11 queryKey: ['todos', todoId],12 queryFn: ({ queryKey }) => fetchTodoById(queryKey[1]),13})错误处理与抛出
为了让 TanStack Query 判定查询发生错误，查询函数必须抛出错误或返回一个被拒绝的 Promise。查询函数中抛出的任何错误都会被持久化到查询的 error 状态中。
TypeScript
1const { error } = useQuery({2 queryKey: ['todos', todoId],3 queryFn: async () => {4 if (somethingGoesWrong) {5 throw new Error('Oh no!')6 }7 if (somethingElseGoesWrong) {8 return Promise.reject(new Error('Oh no!'))9 }10 11 return data12 },13})与 fetch 及其他默认不抛出错误的客户端配合使用
虽然 axios 或 graphql-request 等大多数工具会在 HTTP 请求失败时自动抛出错误，但 fetch 等部分工具默认不会抛出错误。若遇到这种情况，你需要自行抛出错误。以下是使用流行的 fetch API 实现该操作的一种简单方式：
TypeScript
1useQuery({2 queryKey: ['todos', todoId],3 queryFn: async () => {4 const response = await fetch('/todos/' + todoId)5 if (!response.ok) {6 throw new Error('Network response was not ok')7 }8 return response.json()9 },10})查询函数变量
查询键不仅用于唯一标识你正在拉取的数据，还会作为 QueryFunctionContext 的一部分便捷地传入你的查询函数。尽管并非总是必需，但这使得你在需要时可以将查询函数提取出来：
TypeScript
1function Todos({ status, page }) {2 const result = useQuery({3 queryKey: ['todos', { status, page }],4 queryFn: fetchTodoList,5 })6}7 8// Access the key, status and page variables in your query function!9function fetchTodoList({ queryKey }) {10 const [_key, { status, page }] = queryKey11 return new Promise()12}QueryFunctionContext
QueryFunctionContext 是传递给每个查询函数的对象，其包含以下字段：
queryKey: QueryKey：查询键client: QueryClient：QueryClientsignal?: AbortSignal- TanStack Query 提供的 AbortSignal 实例
- 可用于查询取消
meta: Record<string, unknown> | undefined- 一个可选字段，可用于填充有关查询的额外信息
此外，无限查询 还会额外传入以下选项：
pageParam: TPageParam- 用于拉取当前页的页码参数
direction: 'forward' | 'backward'- 已弃用
- 当前页拉取的方向
- 如需获取当前页拉取方向，请在
pageParam中添加 direction 字段，该字段来自getNextPageParam和getPreviousPageParam。