용어정리
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 |