Skip to main content
← Glossary

staleTime

staleTime

TanStack Query가 받은 사본을 다시 확인할 수 있는 오래된 데이터로 분류할 시점을 정하는 옵션이다.

같은 뜻으로 쓰는 말

  • stale time
  • Query 최신성 시간
  • 오래됨 판정 시간

마지막 검증

staleTime은 TanStack Query가 성공적으로 받은 사본을 언제 stale, 즉 다시 확인할 수 있는 오래된 데이터로 분류할지 정한다. 기본값은 0이다. 유한한 숫자를 주면 그 밀리초 동안에는 fresh, 즉 정책상 아직 다시 확인하지 않아도 되는 상태로 본다. Infinity면 수동으로 무효화하기 전까지 stale로 분류하지 않는다.

유한한 시간이 지났다고 그 순간 자동 요청하거나 데이터를 삭제하지는 않는다. 오래된 Query가 새로 화면에 등장하거나 창 초점·네트워크가 돌아오는 등의 다시 가져오기 계기를 만났을 때 요청할 수 있게 만든다. 사용하지 않는 사본을 메모리에 보관하는 gcTime과도 목적이 다르다.

출처와 검증 범위

아래 날짜는 링크를 마지막으로 열어 본 날입니다. 문서 상단의 검증일은 글의 설명과 적용 범위를 다시 확인한 날입니다.

  1. useQueryTanStack · 공식 문서 · 확인 2026-08-09
  2. Important DefaultsTanStack · 공식 문서 · 확인 2026-08-09