gcTime

TanStack Query는 Query 결과를 구독하는 단위를 observer, 즉 구독 관찰자라고 부른다. 기본 설정의 useQuery는 이 관찰자를 만드는 대표적인 Hook이다. 해당 Query를 실제로 구독하는 active observer가 하나도 없으면 inactive, 즉 현재 구독자가 없는 상태가 된다.

gcTime은 Query가 inactive가 된 뒤 캐시 사본을 메모리에 남겨 둘 시간이다. 그 안에 같은 Query의 구독자가 다시 생기면 남은 사본을 바로 사용할 수 있다. 끝까지 다시 쓰이지 않으면 캐시에서 삭제한다.

현재 TanStack Query v5의 클라이언트 기본값은 5분이다. Infinity는 이 자동 삭제를 끈다. staleTime이 사본을 다시 확인할 수 있는 오래된 값으로 분류하는 옵션이라면, gcTime은 사용하지 않는 사본을 메모리에 보존하는 옵션이다. 최신성과 보존은 서로 다른 판단이다.