Formations — 1 037 leçons en français

Accueil › React › Un store externe

Un store externe

Gestion d'étatintermediaire

Un store, c'est trois choses

let etat = { lignes: [] };
const abonnes = new Set();

export const boutique = {
  lire: () => etat,
  sAbonner(notifier) {
    abonnes.add(notifier);
    return () => abonnes.delete(notifier);
  },
  envoyer(action) {
    etat = reducteur(etat, action);
    abonnes.forEach((n) => n());
  },
};

Une valeur, une liste d'abonnés, une fonction qui remplace la valeur et prévient tout le monde. Rien de React là-dedans : cet objet se teste dans un fichier de test ordinaire.

Le brancher sur React

import { useSyncExternalStore } from "react";

function NbLignes() {
  const nb = useSyncExternalStore(
    boutique.sAbonner,
    () => boutique.lire().lignes.length
  );
  return <span>{nb}</span>;
}

Deux fonctions : comment s'abonner, et comment lire la valeur courante. React s'occupe du reste — désabonnement au démontage, et cohérence du rendu.

L'instantané lu doit être stable : la même référence tant que le store n'a pas changé. Ici c'est un nombre, donc la question ne se pose pas. Dès qu'on renvoie un objet construit à la volée, React voit un changement à chaque lecture et signale une boucle.

En pratique, une bibliothèque

import { create } from "zustand";

export const usePanier = create((set) => ({
  lignes: [],
  ajouter: (produit) =>
    set((e) => ({ lignes: [...e.lignes, { ...produit, quantite: 1 }] })),
}));

function NbLignes() {
  const nb = usePanier((e) => e.lignes.length);   // sélecteur
  return <span>{nb}</span>;
}

Zustand s'appuie sur useSyncExternalStore. On écrit le store et les sélecteurs, la bibliothèque fournit l'abonnement, la comparaison et les outils de développement.

Les termes à connaître

Store externe

Un état qui vit en dehors de l'arbre React : un objet de module avec une valeur, une liste d'abonnés, et une fonction pour la changer.

useSyncExternalStore

Le hook qui relie un store externe à React. Il prend une fonction d'abonnement et une fonction qui lit l'instantané courant.

Instantané

La valeur renvoyée par getSnapshot. Elle doit être immuable, et la même référence tant que le store n'a pas changé.

Sélecteur

Une fonction qui extrait du store la part dont un composant a besoin. C'est elle qui décide quand ce composant se redessine.

Déchirure

Deux composants du même rendu affichant deux versions différentes du même état. Le rendu concurrent la rend possible ; useSyncExternalStore l'empêche.

Abonnement stable

La fonction passée en premier argument doit garder son identité entre deux rendus, sinon React se désabonne et se réabonne à chaque fois.

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.