🕵🏻 Tanstack Query (2)

Tanstack Query의 기본값

Tanstack Query를 사용할 때 간혹가다 이 라이브러리의 기본값을 알지 못한다면
학습이나 디버깅에 어려움을 줄 수도 있어 꼭 알아두어야합니다.

---

기본적으로 useQuery, useInfiniteQuery를 통한 쿼리 인스턴스는 캐시된 데이터를 오래된 데이터로 간주합니다.

• 위 동작을 변경하려면 staleTime 옵션을 사용해 전역적으로, 혹은 쿼리별로 구성할 수 있습니다.
  더 긴 staleTime을 지정하면 쿼리가 데이터를 자주 다시 가져오지 않습니다.

---

아래와 같은 경우에는 오래된 데이터를 백그라운드에서 자동으로 다시 fetch합니다.

• 쿼리 마운트의 새로운 인스턴스 (처음으로 쿼리되는 경우)
• 해당 웹페이지에 다시 포커스 할 경우
• 네트워크가 다시 연결되었을 경우
• 선택적으로 refetch 간격을 설정해두었을 경우
• 위 동작들을 변경하려면 refetchOnMount, refetchOnWindowFocus, refetchOnReconnect 및 refetchInterval 과 같은 옵션을 사용할 수 있습니다.

---

useQuery, useInfiniteQuery 또는 쿼리 옵저버의 활성 인스턴스가 더 이상 없는 쿼리 결과는 비활성으로 표시되고 나중에 다시 사용될 경우를 대비해 캐시에 남아있습니다.
또한, 기본적으로 비활성 쿼리는 5분 후에 가비지 컬렉터가 수집합니다.

• 위 동작을 변경하려면 쿼리의 기본 gcTime을 1000 * 60 * 5 밀리초가 아닌 다른 값으로 변경해야 합니다.

---

데이터를 불러오지 못한, 즉 실패한 쿼리는 지수적 백오프 지연 시간을 두고 3번 자동으로 재시도한 후 오류를 캡처하여 UI에 표시합니다.

• 위 동작을 변경하려면 쿼리의 기본 재시도 및 재시도 지연 옵션을 3 이외의 값으로 변경하고,
  기본 지수 백오프 함수를 변경해야 합니다.

---

기본적으로 쿼리 결과는 데이터가 실제로 변경되었는지 감지하기 위해 구조적으로 공유되고 , 그렇지 않은 경우 useMemo 및 useCallback과 관련하여 값 안정화에 더 도움이 되도록 데이터 참조가 변경되지 않습니다. 99.9%의 경우 이를 비활성화할 필요가 없으며 앱의 성능이 향상되고 비용은 전혀 들지 않습니다.

---