RTK Query : points d’accès et mise en cache automatique

Bienvenue

Qu'est-ce que RTK Query ?

Créer une API avec createApi

import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react';

export const userApi = createApi({
  reducerPath: 'userApi',
  baseQuery: fetchBaseQuery({ baseUrl: '/api' }),
  endpoints: (builder) => ({
    getUser: builder.query({ query: (id) => '/users/' + id }),
    getUsers: builder.query({ query: () => '/users' }),
  }),
});

export const { useGetUserQuery, useGetUsersQuery } = userApi;

Ajouter l'API au magasin

import { configureStore } from '@reduxjs/toolkit';
import { userApi } from './userApi';

export const store = configureStore({
  reducer: { [userApi.reducerPath]: userApi.reducer },
  middleware: (gDM) => gDM().concat(userApi.middleware),
});

Utiliser une fonction de requête

function UserCard({ id }) {
  const { data, isLoading, isError } = useGetUserQuery(id);
  if (isLoading) return <Spinner />;
  if (isError) return <p>Error</p>;
  return <p>{data.name}</p>;
}

Déduplication automatique

TTL du cache avec keepUnusedDataFor

endpoints: (builder) => ({
  getUser: builder.query({
    query: id => '/users/' + id,
    keepUnusedDataFor: 300, // 5 minutes
  }),
})

Interrogation périodique des données en direct

const { data } = useGetStatsQuery(undefined, {
  pollingInterval: 5000, // refetch every 5 seconds
});

Arguments de requête et omission conditionnelle

const { data } = useGetUserQuery(userId, { skip: !userId });

Transformer les réponses

getUsers: builder.query({
  query: () => '/users',
  transformResponse: (raw) => raw.data.users,
})

Vérification rapide

Récapitulatif

Suite du cours