React Academy · Pelajaran

Menyediakan React Query & QueryClient

Pasang TanStack Query, balut aplikasi anda dalam QueryClientProvider dan jalankan useQuery pertama anda.

Pelajaran 1 daripada 413 langkah

Menyediakan React Query & QueryClient ialah pelajaran React Academy percuma di CoddyKit. Ini ialah pelajaran 1 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran React Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus React Academy merangkumi sejumlah 4 pelajaran.

Selamat Datang

Dalam pelajaran ini, anda akan memasang TanStack Query, menyediakan QueryClient dan QueryClientProvider, serta menjalankan useQuery pertama anda untuk mendapatkan data daripada API.

Apakah React Query?

TanStack Query (dahulunya React Query) mengurus keadaan pelayan: mendapatkan, menyimpan cache, menyegerakkan dan mengemas kini data daripada sumber jauh. Ia menggantikan keadaan pemuatan/ralat manual dan pengambilan data berasaskan useEffect.

Pemasangan

Pasang pakej teras dan DevTools secara pilihan.
npm install @tanstack/react-query
npm install @tanstack/react-query-devtools --save-dev

Mencipta QueryClient

Cipta tika QueryClient untuk menyimpan semua cache dan konfigurasi. Hantarkannya kepada QueryClientProvider yang membalut aplikasi anda.
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';

const queryClient = new QueryClient();

createRoot(document.getElementById('root')).render(
  <QueryClientProvider client={queryClient}>
    <App />
  </QueryClientProvider>
);

useQuery Pertama Anda

Panggil useQuery dengan tatasusunan queryKey dan queryFn yang mengembalikan data. Kunci itu mengenal pasti entri cache secara unik.
import { useQuery } from '@tanstack/react-query';

function Posts() {
  const { data, isLoading, isError } = useQuery({
    queryKey: ['posts'],
    queryFn: () => fetch('/api/posts').then(r => r.json()),
  });

  if (isLoading) return <p>Loading...</p>;
  if (isError) return <p>Error!</p>;
  return <ul>{data.map(p => <li key={p.id}>{p.title}</li>)}</ul>;
}

Kunci Query

Kunci query ialah tatasusunan. Tambahkan parameter pada kunci untuk mengehadkan skop entri cache. Kunci berbeza = entri cache berbeza.
// All posts
useQuery({ queryKey: ['posts'], queryFn: fetchPosts })

// Post with id 5
useQuery({ queryKey: ['posts', 5], queryFn: () => fetchPost(5) })

// Posts filtered by category
useQuery({ queryKey: ['posts', { category: 'react' }], queryFn: /* ... */ })

Status Query

useQuery mengembalikan beberapa sifat status: `isLoading`, `isFetching`, `isError`, `isSuccess`, `data` dan `error`. `isFetching` bernilai true walaupun untuk pengambilan semula di latar belakang; `isLoading` hanya bernilai true semasa pemuatan pertama.

React Query DevTools

Tambahkan ReactQueryDevtools pada aplikasi anda dalam pembangunan untuk melihat semua entri cache, statusnya dan masa kali terakhir entri itu diambil. Ini amat berguna untuk menyahpepijat.
import { ReactQueryDevtools } from '@tanstack/react-query-devtools';

<QueryClientProvider client={queryClient}>
  <App />
  <ReactQueryDevtools initialIsOpen={false} />
</QueryClientProvider>

Konfigurasi Lalai

Konfigurasikan lalai global pada QueryClient: staleTime, gcTime (pengumpulan sampah), bilangan percubaan semula dan refetchOnWindowFocus.
const queryClient = new QueryClient({
  defaultOptions: {
    queries: {
      staleTime: 60_000,     // data is fresh for 60s
      retry: 2,              // retry failed queries twice
      refetchOnWindowFocus: false,
    },
  },
});

Pengambilan Semula Automatik

Secara lalai, React Query mengambil semula data lapuk apabila: tetingkap mendapat fokus semula, komponen dipasang semula dan rangkaian bersambung semula. Semua ini boleh dikonfigurasikan secara berasingan untuk setiap query.

Semakan Pantas

Apakah tujuan tatasusunan queryKey dalam useQuery?

Ringkasan

Pasang @tanstack/react-query, cipta QueryClient, balut aplikasi anda dengan QueryClientProvider dan panggil useQuery dengan queryKey serta queryFn. Tambahkan DevTools untuk mendapatkan keterlihatan. Konfigurasikan lalai global pada QueryClient.

Seterusnya

Pelajaran seterusnya: **Caching, Stale Time & Background Refetching** — anda akan mengkonfigurasikan staleTime dan gcTime untuk mengawal masa data diambil semula.
Percuma untuk bermula

Pelajari React dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
88
Pelajaran
324

Soalan Lazim

Adakah pelajaran “Menyediakan React Query & QueryClient” percuma?

Ya — teks penuh “Menyediakan React Query & QueryClient” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus React Academy, tingkat taraf kepada CoddyKit PRO. Kursus React Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Menyediakan React Query & QueryClient”?

Pasang TanStack Query, balut aplikasi anda dalam QueryClientProvider dan jalankan useQuery pertama anda. Anda berlatih React Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan React Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran React Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 4.

Berapa lamakah pelajaran “Menyediakan React Query & QueryClient” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran React Academy ini?

Ya. Setiap pelajaran React Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Menyediakan React Query & QueryClient
  2. Caching, Masa Luput & Ambil Semula di Latar
  3. Mutasi dengan useMutation
  4. Tatalan Tanpa Hujung & Penomboran dengan useInfiniteQuery
← Kembali ke React Academy