Framework
Version

安裝

安裝

您可以透過 NPM 安裝 React Query,或是透過 ESM.sh 使用傳統的 <script> 標籤引入。

NPM

bash
npm i @tanstack/react-query
npm i @tanstack/react-query

bash
pnpm add @tanstack/react-query
pnpm add @tanstack/react-query

bash
yarn add @tanstack/react-query
yarn add @tanstack/react-query

bash
bun add @tanstack/react-query
bun add @tanstack/react-query

React Query 相容於 React v18+ 版本,並可在 ReactDOM 和 React Native 環境中使用。

想在下載前試用看看嗎?試試 simplebasic 範例!

CDN

如果您沒有使用模組打包工具或套件管理器,也可以透過 ESM.sh 這類支援 ESM 的 CDN 來使用此函式庫。只需在 HTML 檔案底部加入 <script type="module"> 標籤:

html
<script type="module">
  import React from 'https://esm.sh/[email protected]'
  import ReactDOM from 'https://esm.sh/[email protected]'
  import { QueryClient } from 'https://esm.sh/@tanstack/react-query'
</script>
<script type="module">
  import React from 'https://esm.sh/[email protected]'
  import ReactDOM from 'https://esm.sh/[email protected]'
  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
Chrome >= 91
Firefox >= 90
Edge >= 91
Safari >= 15
iOS >= 15
Opera >= 77

根據您的環境,可能需要加入 polyfill。如果您需要支援舊版瀏覽器,需自行從 node_modules 轉譯函式庫。

建議

建議同時使用我們的 ESLint Plugin Query 來幫助您在編碼時捕捉錯誤和不一致。您可以透過以下指令安裝:

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

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

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

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