본문으로 건너뛰기

설치

NPM을 통해 React Query를 설치할 수 있습니다, 또는 다음을 통해 익숙한 <script>를 사용합니다 ESM.sh.

NPM

npm i @tanstack/react-query

or

pnpm add @tanstack/react-query

or

yarn add @tanstack/react-query

or

bun add @tanstack/react-query

or

deno add @tanstack/react-query

React Query는 React v18+와 호환되며 ReactDOM 및 React Native와 함께 작동합니다.

다운로드하기 전에 한번 사용해 보고 싶으신가요? 간단한 또는 기본 예제를 사용해 보세요!

CDN

모듈 번들러나 패키지 관리자를 사용하지 않는 경우 ESM.sh와 같은 ESM 호환 CDN을 통해서도 이 라이브러리를 사용할 수 있습니다. HTML 파일 하단에 <script type="module"> 태그를 추가하기만 하면 됩니다:

<script type="module">
import React from 'https://esm.sh/react@18.2.0'
import ReactDOM from 'https://esm.sh/react-dom@18.2.0'
import { QueryClient } from 'https://esm.sh/@tanstack/react-query'
</script>

JSX 없이 React를 사용하는 방법은 여기에서 확인할 수 있습니다.

요구 사항

React Query는 최신 브라우저에 최적화되어 있습니다. 다음 브라우저 구성과 호환됩니다

Chrome >= 91
Firefox >= 90
Edge >= 91
Safari >= 15
iOS >= 15
Opera >= 77

환경에 따라 polyfill을 추가해야 할 수 있습니다. 이전 브라우저를 지원하려면 node_modules의 라이브러리를 직접 transpile해야 합니다.

권장 사항

코딩 중 버그와 불일치를 발견하는 데 도움이 되도록 ESLint Plugin Query도 사용하는 것이 좋습니다. 다음을 통해 설치할 수 있습니다:

npm i -D @tanstack/eslint-plugin-query

or

pnpm add -D @tanstack/eslint-plugin-query

or

yarn add -D @tanstack/eslint-plugin-query

or

bun add -D @tanstack/eslint-plugin-query