Formations — 1 037 leçons en français

Accueil › React › Synchroniser avec l'extérieur

Synchroniser avec l'extérieur

Les effetsintermediaire

Un effet sert à synchroniser le composant avec quelque chose d'extérieur à React : le titre du document, un minuteur, un abonnement, une connexion.

function Onglet({ titre }) {
  useEffect(() => {
    document.title = titre;        // le document n'est pas géré par React
  }, [titre]);

  return <h1>{titre}</h1>;
}

React appelle d'abord le composant pour calculer le JSX, applique le résultat au document, laisse le navigateur peindre, puis lance l'effet. Le rendu reste pur ; tout ce qui sort de React est décalé après.

Réagir à un rendu, ou réagir à un événement

C'est la seule question à se poser avant d'écrire useEffect.

// ❌ un achat ne vient pas d'un rendu
useEffect(() => {
  if (panierValide) envoyerCommande(panier);
}, [panierValide]);

// ✅ il vient d'un clic
<button onClick={() => envoyerCommande(panier)}>Acheter</button>

Un effet répond à « le composant est affiché avec ces valeurs ». Un gestionnaire répond à « l'utilisateur a fait ceci ». Les deux ne sont pas interchangeables : l'effet se relance à chaque changement de dépendance, au remontage, et deux fois en développement sous le mode strict. Une commande partirait en double.

Avant d'écrire un effet, cherchez le système extérieur qu'il synchronise. S'il n'y en a aucun, l'effet n'a probablement pas sa place.

Les termes à connaître

Effet

Du code qui synchronise le composant avec quelque chose d'extérieur à React : le titre du document, un minuteur, un abonnement, une connexion, une trace envoyée au serveur.

useEffect

Le hook qui déclare un effet. Il prend une fonction et, en second argument, la liste des valeurs dont elle dépend.

Système extérieur

Tout ce que React ne gère pas : le navigateur, le réseau, une bibliothèque tierce, un stockage local. Le terme anglais est external system.

Rendu

L'appel du composant par React pour obtenir le JSX à afficher. Il doit être pur : aucun effet de bord pendant le rendu.

Validation (commit)

Le moment où React applique au document les changements calculés par le rendu. Les effets useEffect sont lancés après, une fois l'écran peint.

useLayoutEffect

La variante qui s'exécute avant que le navigateur peigne. Réservée aux mesures de position dont dépend l'affichage ; elle bloque la peinture.

Gestionnaire d'événement

Une fonction appelée parce que l'utilisateur a fait quelque chose. C'est l'endroit des actions, pas des synchronisations.

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.