React-Query介绍以及简单使用
1.为什么有react-query?
- 传统项目中,大多数开发者可能采用Redux来维护项目的状态,例如某个按钮的loading状态,某个异步请求获得的列表数据等等。
- 因为异步请求数据,所以我们在代码里面需要维护异步请求的loading,返回的数据等等一系列状态,以及每个页面我们还需要在useEffect中调用接口,初始化数据。当我们需要更新数据时,又要手动去重新调用该方法。
而React-Query的出现正是解决了我们以上问题,当然我觉得最重要的是该库增加了缓存的概念,并且与Next.JS适配的很好。也提供了很多便利的API(例如无限加载,分页等等,都不需要开发者自己再去维护很多状态)可以让我们前端开发更高效,性能也更好。最重要的是,让我们开发者少写代码。并且React-Query和Redux的配合使用,可以让我们保持服务器和客户端状态分开。
2.React-Query是什么?
React Query 因其极大地简化了 React 应用程序中的数据获取而受到许多人的喜爱。但是它并不是数据获取库,它应该叫异步状态管理器,它可以管理任何形式的异步状态——只要它得到一个 Promise。
3.查询的键值(query-keys)
从本质上讲,React Query 基于查询键值为您管理查询缓存。 只要键值是可序列化的,并且对查询的数据来说。它是唯一的,就可以使用它。虽然支持用字符串,但还是建议使用数组形式,因为内部最终还是会转化成数组。
- 依赖项
React Query 将在查询键更改时触发重新获取。这样我们就可以不必再写手动触发重新请求接口获取新数据的代码。下述代码,当我们的state被更新时,就会重新请求接口。
useQuery(['todos', state], () => fetchTodos(state))
- QueryKey唯一标识了您的查询,因此只要您在两个不同的地方使用相同的键调用查询,它们就会得到相同的数据。这可以通过自定义钩子最好地抽象出来,这样我们就不必两次访问实际的数据获取函数
export const useTodos = () => useQuery(['todos'], fetchTodos)
function ComponentOne() {
const { data } = useTodos()
}
function ComponentTwo() {
const { data } = useTodos()
}
- 一般会创建一个QueryKey的工厂,会使我们扩展性更强,也减少出错的概率。
const SEARCH_DEMO_RESULT = 'search_demo_result';
export {SEARCH_DEMO_RESULT}
4.自动请求
React Query 很聪明,它会选择策略点来触发重新获取数据。
-
refetchOnMount
每当一个调用useQuery的新组件挂载时,React Query 都会重新验证。 -
refetchOnWindowFocus
每当您聚焦浏览器选项卡时,都会重新获取。这是我最喜欢进行重新验证的时间点,但它经常被误解。在开发过程中,我们经常切换浏览器选项卡,因此我们可能会认为这“太多”了。然而,在生产环境中,这很可能表明在标签页中打开我们的应用程序的用户现在从查看邮件或阅读 Twitter 回来了。在这种情况下,向他们展示最新的更新非常有意义。 -
refetchOnReconnect
如果您失去网络连接并重新获得它,这也是重新验证您在屏幕上看到的内容的一个很好的指标。
5.staleTime和catchTime
- staleTime
数据保质期,在保质期内遇到同 key 的请求,不会去再次获取数据,也就是从缓存中取,瞬间切换展示。 - catchTime
数据在内存中缓存的时间,在缓存时间内遇到同key请求,缓存数据会立即取出,但是否重新请求数据,是看staleTime是否过期。
此时就需要介绍useQuery返回的两种loading - isLoading
isLoading是没有缓存时的加载,是指在内存中没有该缓存时的加载。 - isFetching
isFetching是每次请求时的加载。
6.数据转换
数据转换也是前端经常遇到的问题,因为API返回的数据可能不是我们刚好能用的,react-query也提供了转换器,并且也只在有数据的时候才会被调用。
useQuery(['todos'], fetchTodos, {
select: (data) => data.map((todo) => todo.name.toUpperCase()),
})
因为每次渲染都会执行,如果转换数据的方法开销比较大,建议使用useCallback将select函数缓存起来。
useQuery(['todos'], fetchTodos, {
select: useCallback(
(data: Todos) => data.map((todo) => todo.name.toUpperCase()),
[]
),
7.initialData和placeholderData
初始化数据,也就是数据没有缓存时直接展示的内容,当缓存中有该数据时,则不会生效。
- inititalData
initialData会被持久化到缓存中。当存到缓存中,就会受到staleTime或者catchTime等等机制的影响。 - placeholderData
可以理解为假的数据,直到真实的数据出现。
8.NextJS中使用React-Query,初始化数据
如何读取缓存中的数据?
const queryClient = useQueryClient();
queryClient.getQueriesData([SEARCH_DEMO_RESULT])