1. 중요한 기본들(Important Defaults)

Out of the box(별도의 설치가 필요없이), TanStack Query는 적극적이지만 (제대로 동작되게) 설정된다. 가끔 이런 기본설정값들은 신규 사용자에게 학습/디버깅을 어렵게 만든다. TanStack Query를 계속 학습하고, 사용할 때 이러한 정보를 제공한다:

(1) useQuery 또는 useInfiniteQuery를 통한 Query instance는 캐시된 데이터는 오래된 것(stale)으로 간주한다.

이 동작을 변경하려면, staleTime 옵션을 사용하여 쿼리를 전역 및 쿼리별로 구성할 수 있습니다. staleTime 옵션을 더 길게 지정하면, query들이 자주 데이터를 refetch하지 않는다.

(2) 오래된 queries는 (다음과 같은 상황에) 자동적으로 백그라운드에서 refetch 된다.

• query mount의 새 인스턴스
• 윈도우가 refocus 되었을 때
• netework가 다시 연결되었을 때
• 쿼리가 refetch interval 설정되었을 때

이 기능을 변경하려면 refetchOnMount, refetchOnWindowsFocus, refetchOnReconnect 및 refetchInterval과 같은 옵션을 사용할 수 있다.

(3) 더 이상 사용되지 않는 인스턴스인 useQuery, useInfiniteQuery 또는 query observers들의 Query 결과들은 비활성(inactive) 레이블로 지정되며, 나중에 다시 사용될 경우 캐시에 남아 있다.

(4) 기본적으로 비활성화된 query들은 5분 후에 가비지 콜렉터로부터 회수당한다.

이를 변경하려면, 쿼리의 기본 gcTime을 1000 * 60 * 5 밀리초가 아닌 다른 것으로 변경하면 된다.

(5) 데이터를 가져오는데 실패한 query들은 3번 자동으로 재시도한다. (대표적인 뒷걸음질(backoff, 여기서는 오류)의 delay와 함께,) (UI에 오류를 찾아서 표시하기 전에,)

이를 변경하려면, 쿼리에 대한 retry 및 retryDelay 옵션을 3과 (, 기본 backoff 함수)이 아닌 다른 항목으로 변경한다.

(6) 기본적으로 쿼리 결과는 구조적으로 공유되어 있다. (^만약 데이터가 실제로 변경되어 있는지 감지하기 위해서,) (데이터 변경을 감지하지 못한다면, 데이터 참조는 변화하지 않은채 유지된다.) (더 나은 값 안전화를 돕기 위해,) (useMemo 및 useCallback르 다루는데(regards),)

이 개념이 생소하게(foreign) 들린다면 걱정하지 않아도 된다! 99.9%의 경우 사용자가 이를 비활성화할 필요가 없으며, 앱을 공짜로 더 나은 성능을 발휘할 수 있다.

2. 더 알아보기

기본값에 대한 자세한 설명은 커뮤니티 리소스의 다음 문서를 참조.

• 실용적인 React 쿼리, 1-practical-react-query
• 상태 관리자로서의 React Query, 10-react-query-as-a-state-manager