용어정리

TanStack Query(React Query)

요코딩 2024. 9. 20. 10:25
옵션 설명 기본값
enabled 쿼리 자동 실행 여부
(false인 경우, 대기 상태 pending 으로 시작)
 true
gcTime 비활성 캐시 데이터(inactive)가 메모리에 남아 있는 시간(ms).  
initialDate 쿼리가 생성되거나 캐시되기 전에 사용하는 초기 데이터  
initiaDataUpdatedAt 초기 데이터의 마지막 업데이트 시간 설정  
meta 활용할 메타 정보를 저장  
networkMode 네트워크 모드 설정 online
notifyOnChangeProps 변경 시 알림 받을 속성 설정  
placeholderData 대기(pending)중인 상태에서 사용할 데이터  
queryClient 커스텀 쿼리 클라이언트 연결  
queryFn 데이터를 가져오는 쿼리 함수로, 꼭 데이터를 반환하거나 오류를 던져야 함.
기본 쿼리 함수가 지정되지 않은 경우에만 필수 옵션!
 
queryKey 고유한 쿼리 키(식별자,id),  필수옵션  
queryKeyHashFn 쿼리 키를 해쉬 하는 함수  
refetchInterval 데이터 자동 갱신(다시 가져오기)의 시간 간격(ms)  
refetchIntervalInBackground 백그라운드에서 데이터 자동 갱신 여부 false
refetchOnMount useQuery 연결 시 데이터 갱신 여부.
true : 연결 시 데이터가 상한 경우만 갱신
always : 연결 시 데이터 항상 갱신
true
refetchOnReconnect 네트워크 재연결 시 데이터 갱신 여부 true
refetchOnWindowFocus 브라우저 화면 포커스 시 데이터 갱신 여부 true
retry 쿼리 실패 시 재시도 횟수 3
retryDelay 재시도 시간 간격(ms)  
retryOnMount useQuery 연결 시 재시도 여부 true
select 가져온 데이터를 변형(tjsxor)하는 함수  
staleTime 데이터가 상하는데 걸리는 시간(ms) 0
structuralSharing 데이터 구조의 재사용을 최적화해, 불변성을 유지하고 불필요한 리렌더링 방지 true
throwOnError 쿼리 실패 시 오류를 던질지 여부 undefined