Formations — 1 037 leçons en français

Accueil › React › setEtat avec une fonction

setEtat avec une fonction

L'état avec useStatedebutant

Une variable d'état est figée pour la durée du rendu. setN ne la réécrit pas : il programme le rendu suivant.

const [n, setN] = useState(0);

function cliquer() {
  setN(n + 1);          // n vaut 0 → setN(1)
  setN(n + 1);          // n vaut toujours 0 → setN(1)
  console.log(n);       // 0
}

Après ce clic, le compteur vaut 1, pas 2. Les deux appels ont écrit la même valeur, parce qu'ils ont lu le même n.

La forme fonctionnelle

function cliquer() {
  setN((n) => n + 1);   // reçoit 0, rend 1
  setN((n) => n + 1);   // reçoit 1, rend 2
}

En passant une fonction, on ne dit plus « la nouvelle valeur est 1 » mais « la nouvelle valeur est l'ancienne plus un ». React empile ces fonctions dans une file et les applique l'une après l'autre : chacune reçoit le résultat de la précédente. Le compteur arrive à 2.

Un seul rendu pour trois appels

React n'effectue pas un rendu par set. Il attend la fin du gestionnaire, puis applique tout d'un coup. C'est le regroupement — depuis React 18, il s'applique aussi dans un minuteur ou après un await.

La règle pratique

Si la nouvelle valeur dépend de l'ancienne, passez une fonction. Sinon, une valeur suffit : setNom("Anne") n'a rien à dériver.

Les termes à connaître

Forme fonctionnelle

setN((n) => n + 1) : on passe une fonction qui reçoit la valeur en attente et rend la suivante, au lieu de passer une valeur calculée.

Instantané du rendu

Les variables d'état d'un rendu sont figées pour toute sa durée. n ne change pas après un setN : c'est le rendu suivant qui voit la nouvelle valeur.

File de mises à jour

La liste des mises à jour accumulées avant le prochain rendu. React les applique dans l'ordre pour calculer l'état final.

Regroupement

React attend la fin du gestionnaire d'événement avant de rendre, et applique toutes les mises à jour d'un coup. Un seul rendu pour trois set.

Valeur périmée

Une variable d'état lue dans une fermeture créée à un rendu antérieur. Elle contient ce qu'elle valait alors, pas la valeur courante.

Fonction de mise à jour pure

La fonction passée au setter ne doit rien faire d'autre que calculer et rendre la valeur suivante : React peut l'appeler plusieurs fois.

flushSync

La fonction de react-dom qui force un rendu immédiat avant de poursuivre. Utile pour mesurer le DOM juste après une mise à jour, à éviter sinon.

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.