staleTime
staleTime
TanStack Query가 받은 사본을 다시 확인할 수 있는 오래된 데이터로 분류할 시점을 정하는 옵션이다.
같은 뜻으로 쓰는 말
- stale time
- Query 최신성 시간
- 오래됨 판정 시간
마지막 검증
staleTime은 TanStack Query가 성공적으로 받은 사본을 언제 stale, 즉 다시 확인할 수 있는 오래된
데이터로 분류할지 정한다. 기본값은 0이다. 유한한 숫자를 주면 그 밀리초 동안에는 fresh, 즉
정책상 아직 다시 확인하지 않아도 되는 상태로 본다. Infinity면 수동으로 무효화하기 전까지 stale로
분류하지 않는다.
유한한 시간이 지났다고 그 순간 자동 요청하거나 데이터를 삭제하지는 않는다. 오래된 Query가 새로 화면에
등장하거나 창 초점·네트워크가 돌아오는 등의 다시 가져오기 계기를 만났을 때 요청할 수 있게 만든다.
사용하지 않는 사본을 메모리에 보관하는 gcTime과도 목적이 다르다.
출처와 검증 범위
아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.
- useQueryTanStack · 공식 문서 · 확인 2026-08-09
- Important DefaultsTanStack · 공식 문서 · 확인 2026-08-09