Formations — 1 037 leçons en français

Accueil › React › Requêtes concurrentes

Requêtes concurrentes

État serveur et cacheavance

Une clé, une requête

// Trois composants, trois appels, une seule requête réseau
function Entete()  { const { data } = useQuery({ queryKey: ["moi"], queryFn: lireMoi }); … }
function Menu()    { const { data } = useQuery({ queryKey: ["moi"], queryFn: lireMoi }); … }
function Journal() { const { data } = useQuery({ queryKey: ["moi"], queryFn: lireMoi }); … }

La clé identifie la donnée, donc aussi la requête en cours pour cette donnée. Une demande qui arrive pendant qu'une requête de même clé est en vol s'y abonne au lieu d'en lancer une seconde.

Conséquence pratique : on n'a plus besoin de remonter la donnée dans un parent pour éviter les doublons. Chaque composant demande ce dont il a besoin, là où il en a besoin.

Un nombre variable de requêtes

const resultats = useQueries({
  queries: ids.map((id) => ({
    queryKey: ["client", id],
    queryFn: () => chargerClient(id),
  })),
});

Des useQuery dans une boucle appelleraient un nombre de hooks variable, ce que les règles des hooks interdisent. useQueries fait un seul appel et rend un tableau de la même longueur que queries, dans le même ordre.

Une requête qui dépend d'une autre

const { data: utilisateur } = useQuery({ queryKey: ["utilisateur", email], queryFn: … });

const { data: projets } = useQuery({
  queryKey: ["projets", utilisateur?.id],
  queryFn: () => chargerProjets(utilisateur.id),
  enabled: Boolean(utilisateur?.id),
});

Sans enabled, queryFn partirait avec undefined et la clé ["projets", undefined] collecterait une réponse d'erreur. Avec, la seconde requête attend — et reste en pending, puisqu'elle n'a ni donnée ni erreur.

Deux requêtes en cascade coûtent deux allers-retours. Quand c'est mesurable, la bonne réponse est souvent côté serveur : un point d'entrée qui renvoie les deux.

Les termes à connaître

Déduplication

Le regroupement de plusieurs demandes simultanées de la même clé en une seule requête réseau. Tous les observateurs reçoivent la même réponse.

Requête en vol

Une requête partie et pas encore revenue. C'est elle que la déduplication partage, et elle qu'une nouvelle demande de même clé rejoint au lieu d'en lancer une autre.

useQueries

Le hook qui lance un nombre variable de requêtes en parallèle, là où des useQuery en boucle violeraient les règles des hooks.

Requête dépendante

Une requête dont les paramètres viennent d'une autre. L'option enabled la retient tant que ce dont elle a besoin n'est pas arrivé.

placeholderData

Une valeur affichée en attendant la vraie, sans être écrite dans le cache. Sous la forme (precedent) => precedent, elle garde la page précédente visible pendant le chargement de la suivante.

Course aux réponses

Deux requêtes parties dans un ordre et revenues dans l'autre. Le cache par clé l'empêche ; un useState rempli dans un effet ne l'empêche pas.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.