Les Hooks sont une nouveauté de React 16.8. Ils permettent de bénéficier d’un état local et d’autres fonctionnalités de React sans avoir à écrire de classes.

Cette page contient les réponses aux questions les plus fréquentes sur les Hooks.

• Stratégie d’adoption

  • Quelles versions de React incluent les Hooks ?
  • Dois-je réécrire tous mes composants à base de classe ?
  • Que puis-je faire avec les Hooks qu’il est impossible de faire avec des classes ?
  • Quelle proportion de mes connaissances en React reste pertinente ?
  • Dois-je utiliser des Hooks, des classes ou un mélange des deux ?
  • Est-ce que les Hooks couvrent tous les cas d’utilisation des classes ?
  • Est-ce que les Hooks remplacent les props de rendu et les composants d’ordre supérieur ?
  • Qu’est-ce que les Hooks changent pour les API populaires telles que Redux connect() et React Router ?
  • Est-ce que les Hooks sont compatibles avec le typage statique ?
  • Comment tester des composants utilisant des Hooks ?
  • Qu’est-ce que les règles de linting imposent ?

• Des classes aux Hooks

  • Quelles sont les correspondances entre les méthodes de cycle de vie et les Hooks ?
  • Comment charger des données distantes avec les Hooks ?
  • Existe-t-il un équivalent aux variables d’instances ?
  • Dois-je utiliser une ou plusieurs variables d’état local ?
  • Puis-je exécuter un effet seulement lors des mises à jour ?
  • Comment récupérer les props ou l’état local précédents ?
  • Pourquoi vois-je des props ou un état local obsolètes dans ma fonction ?
  • Comment puis-je implémenter getDerivedStateFromProps ?
  • Existe-t-il un équivalent à forceUpdate ?
  • Puis-je créer une ref vers une fonction composant ?
  • Comment puis-je mesurer un nœud DOM ?
  • Que signifie const [thing, setThing] = useState() ?

• Optimisations des performances

  • Puis-je sauter un effet lors des mises à jour ?
  • Est-il acceptable d’omettre les fonctions du tableau de dépendances ?
  • Que faire quand mes dépendances d’effet changent trop souvent ?
  • Comment puis-je implémenter shouldComponentUpdate ?
  • Comment mémoïser les calculs ?
  • Comment créer paresseusement des objets coûteux ?
  • La création de fonctions à la volée pendant le rendu ralentit-elle les Hooks ?
  • Comment éviter de transmettre des fonctions de rappel ?
  • Comment lire une valeur changeant fréquemment avec useCallback ?

• Sous le capot

  • Comment React associe-t-il les appels de Hooks avec les composants ?
  • Quelles sont les sources d’inspiration des Hooks ?

Stratégie d’adoption

Quelles versions de React incluent les Hooks ?

Depuis la version 16.8.0, React embarque une implémentation stable de React Hooks pour :

• React DOM
• React Native
• React DOM Server
• Le moteur de rendu de test de React
• Le moteur de rendu superficiel de React

Remarquez que pour activer les Hooks, tous les paquets React doivent être en version 16.8.0 ou supérieure. Les Hooks ne fonctionneront pas si vous oubliez de mettre à jour React DOM, par exemple.

React Native 0.59 et ultérieurs prennent en charge les Hooks.

Dois-je réécrire tous mes composants à base de classe ?

Non. Il n’est pas prévu de retirer les classes de React : nous avons tous besoin de continuer à livrer nos produits et ne pouvons pas nous permettre de réécrire tout le code. Nous recommandons d’essayer les Hooks dans de nouveaux composants et projets.

Que puis-je faire avec les Hooks qu’il est impossible de faire avec des classes ?

Les Hooks offrent un nouveau moyen puissant et expressif de réutiliser des fonctionnalités entre composants. « Contruire vos propres Hooks » offre un aperçu des possibilités. Cet article (en anglais) écrit par un membre de l’équipe noyau de React explore plus en détail les nouvelles possibilités apportées par les Hooks.

Quelle proportion de mes connaissances en React reste pertinente ?

Les Hooks sont un moyen plus direct d’utiliser les fonctionnalités de React que vous connaissez déjà, telles que l’état local, le cycle de vie, le contexte et les refs. Ils ne changent pas fondamentalement la façon dont React fonctionne, et vos connaissances des composants, des props, et du flux de données descendant sont toujours valides.

Les Hooks ont tout de même une courbe d’apprentissage. Si quelque chose manque dans leur documentation, créez un ticket sur le dépôt GitHub et nous essaierons de vous aider.

Dois-je utiliser des Hooks, des classes ou un mélange des deux ?

Quand vous serez prêt·e, nous vous conseillons de commencer à essayer les Hooks dans les nouveaux composants que vous écrirez. Assurez-vous que chaque membre de votre équipe soit partant·e pour les utiliser, et à l’aise avec cette documentation. Nous déconseillons de réécrire vos classes existantes avec les Hooks, sauf si vous aviez déjà prévu de les réécrire de toute façon (ex. pour corriger des bugs).

Vous ne pouvez pas utiliser les Hooks à l’intérieur d’un composant à base de classe, mais vous pouvez complètement mélanger classes et fonctions composants utilisant des Hooks dans une même arborescence. Qu’un composant soit une classe ou une fonction utilisant les Hooks ne constitue qu’un détail d’implémentation de ce composant. Sur le long terme, nous nous attendons à ce que l’essentiel des composants React soient écrits à base de Hooks.

Est-ce que les Hooks couvrent tous les cas d’utilisation des classes ?

Notre but est que les Hooks couvrent tous les cas d’utilisation des classes dès que possible. Il n’existe pas pour l’instant d’équivalent en Hook pour les méthodes de cycle de vie moins courantes que sont getSnapshotBeforeUpdate, getDerivedStateFromError et componentDidCatch, mais nous prévoyons de les ajouter rapidement.

Est-ce que les Hooks remplacent les props de rendu et les composants d’ordre supérieur ?

Souvent, les props de rendu et les composants d’ordre supérieur n’affichent qu’un seul enfant. Nous pensons que les Hooks simplifient ce cas d’utilisation. Ces deux approches restent pertinentes (par exemple, un composant de défilement virtuel pourrait avoir une prop renderItem, ou un composant de conteneur visuel pourrait avoir sa propre structure DOM). Mais dans la plupart des cas, les Hooks seront suffisants et pourront aider à réduire l’imbrication dans votre arborescence de composants.

Qu’est-ce que les Hooks changent pour les API populaires telles que Redux connect() et React Router ?

Vous pouvez continuer à utiliser les mêmes API que d’habitude ; elles fonctionneront toujours comme avant.

Depuis sa version v7.1.0, React-Redux prend en charge l’API des Hooks et fournit des Hooks tels que useDispatch et useSelector.

React Router prend en charge les Hooks depuis sa v5.1.

D’autres bibliothèques pourront prendre en charge les Hooks à l’avenir.

Est-ce que les Hooks sont compatibles avec le typage statique ?

Les Hooks ont été conçus avec le typage statique à l’esprit. Comme ce sont des fonctions, il est plus facile de les typer correctement que d’autres approches telles que les composants d’ordre supérieur. Les dernières définitions Flow et TypeScript pour React prennent en charge les Hooks React.

Surtout, les Hooks personnalisés vous donnent la possibilité de restreindre l’API React si vous souhaitez les typer de façon plus stricte. React vous fournit des primitives, mais vous pouvez les combiner de façons différentes de celles que nous fournissons d’entrée de jeu.

Comment tester des composants utilisant des Hooks ?

Du point de vue de React, un composant utilisant des Hooks est un composant normal. Si votre solution de test ne repose pas sur des fonctionnements internes de React, tester des composants avec des Hooks ne devrait pas être différent de la façon dont vous testez vos composants habituellement.

Note

Testing Recipes inclut plusieurs exemples que vous pouvez copier-coller.

Par exemple, prenons ce composant de comptage :

function Example() {
  const [count, setCount] = useState(0);
  useEffect(() => {
    document.title = `Vous avez cliqué ${count} fois`;
  });
  return (
    <div>
      <p>Vous avez cliqué {count} fois</p>
      <button onClick={() => setCount(count + 1)}>
        Cliquez ici
      </button>
    </div>
  );
}

Nous le testerons en utilisant React DOM. Pour être certains que le comportement correspond à ce qui se passerait dans le navigateur, nous enroberons le code d’affichage et de mise à jour par des appels à ReactTestUtils.act() :

import React from 'react';
import ReactDOM from 'react-dom/client';
import { act } from 'react-dom/test-utils';import Counter from './Counter';

let container;

beforeEach(() => {
  container = document.createElement('div');
  document.body.appendChild(container);
});

afterEach(() => {
  document.body.removeChild(container);
  container = null;
});

it('can render and update a counter', () => {
  // Test du premier rendu et de son effet
  act(() => {    ReactDOM.createRoot(container).render(<Counter />);  });  const button = container.querySelector('button');
  const label = container.querySelector('p');
  expect(label.textContent).toBe('Vous avez cliqué 0 fois');
  expect(document.title).toBe('Vous avez cliqué 0 fois');

  // Test du second rendu et de son effet
  act(() => {    button.dispatchEvent(new MouseEvent('click', {bubbles: true}));  });  expect(label.textContent).toBe('Vous avez cliqué 1 fois');
  expect(document.title).toBe('Vous avez cliqué 1 fois');
});

Les appels à act() vont aussi traiter les effets qu’ils contiennent.

Si vous souhaitez tester un Hook personnalisé, c’est possible en créant un composant dans votre test, et en utilisant le Hook depuis celui-ci. Vous pourrez alors tester le composant que vous venez de créer.

Pour réduire le code générique, nous vous conseillons d’utiliser React Testing Library qui est conçu de manière à encourager l’écriture de tests utilisant les composants comme le feraient les utilisateurs finaux.

Pour plus d’information, consultez Testing Recipes.

Qu’est-ce que les règles de linting imposent ?

Nous mettons à disposition un plugin ESlint qui impose les règles des Hooks pour éviter les bugs. Il part du principe que toute fonction commençant par ”use” suivi d’une lettre majuscule est un Hook. Nous admettons que cette heuristique n’est pas parfaite et peut déclencher des faux positifs, mais sans convention au niveau de l’écosystème, il n’existe aucun moyen de faire fonctionner les Hooks correctement—et des noms plus longs décourageront l’adoption des Hooks ou le respect des conventions par la communauté.

En particulier, la règle impose que :

• Les appels de Hooks soient situés soit à l’intérieur d’une fonction nommée en casse PascalCase (supposée être un composant) ou d’une autre fonction useSomething (supposée être un Hook personnalisé).
• Les Hooks soient appelés dans le même ordre à chaque rendu.

Il existe quelques autres heuristiques, et elles changeront peut-être avec le temps, au fur et à mesure que nous peaufinons la règle pour améliorer la découverte de bugs tout en évitant les faux positifs.

Des classes aux Hooks

Quelles sont les correspondances entre les méthodes de cycle de vie et les Hooks ?

• constructor : les fonctions composants n’ont pas besoin d’un constructeur. Vous pouvez initialiser l’état local lors de l’appel à useState. Si le calcul de l’état local initial est trop coûteux, vous pouvez passer une fonction à useState.
• getDerivedStateFromProps : planifiez plutôt une mise à jour pendant le rendu.
• shouldComponentUpdate : voyez React.memo ci-dessous.
• render : c’est le corps-même de la fonction composant.
• componentDidMount, componentDidUpdate, componentWillUnmount : le Hook useEffect peut exprimer toutes les combinaisons de celles-ci (y compris des cas moins fréquents).
• getSnapshotBeforeUpdate, componentDidCatch et getDerivedStateFromError : il n’existe pas encore de Hook équivalent pour ces méthodes, mais ils seront ajoutés prochainement.

Comment charger des données distantes avec les Hooks ?

Voici une petite démo pour vous aider à démarrer. Pour en apprendre davantage, jetez un œil à cet article (en anglais) sur le chargement de données distantes avec les Hooks.

Existe-t-il un équivalent aux variables d’instances ?

Oui ! Le Hook useRef() n’est pas seulement pour les refs au DOM. L’objet “ref” est un conteneur générique dont la propriété current est modifiable et peut contenir n’importe quelle valeur, de la même façon qu’une propriété d’instance dans une classe.

Vous pouvez lui affecter une valeur depuis useEffect :

function Timer() {
  const intervalRef = useRef();
  useEffect(() => {
    const id = setInterval(() => {
      // ...
    });
    intervalRef.current = id;    return () => {
      clearInterval(intervalRef.current);
    };
  });

  // ...
}

Si nous avions juste voulu définir une horloge, nous n’aurions pas eu besoin de la ref (id pouvait rester local à l’effet) mais ça peut être utile si nous voulons arrêter l’horloge depuis un gestionnaire d’événements.

  // ...
  function handleCancelClick() {
    clearInterval(intervalRef.current);  }
  // ...

Conceptuellement, vous pouvez vous représenter les refs comme des variables d’instance dans une classe. À moins que vous n’ayez recours à de l’initialisation paresseuse, évitez d’écrire dans vos refs pendant le rendu : ça peut donner des comportements hasardeux. Au lieu de ça, vous voudrez généralement modifier les refs au sein de gestionnaires d’événements ou d’effets.

Dois-je utiliser une ou plusieurs variables d’état local ?

Si vous avez l’habitude des classes, vous serez peut-être tenté·e de toujours appeler useState() une seule fois, en mettant tout l’état local dans un unique objet. Si vous y tenez, c’est tout à fait possible. Voici un exemple d’un composant qui piste le mouvement de la souris. Nous gardons sa position et sa taille dans l’état local :

function Box() {
  const [state, setState] = useState({ left: 0, top: 0, width: 100, height: 100 });
  // ...
}

Maintenant, disons que nous voulons écrire un bout de code pour modifier left et top quand l’utilisateur bouge la souris. Voyez comme nous devons fusionner manuellement ces champs dans l’état local précédent :

  // ...
  useEffect(() => {
    function handleWindowMouseMove(e) {
      // La décomposition de "...state" permet de s’assurer qu’on ne « perd » pas width et height      setState(state => ({ ...state, left: e.pageX, top: e.pageY }));    }
    // Remarque : cette implémentation est un peu simplifiée
    window.addEventListener('mousemove', handleWindowMouseMove);
    return () => window.removeEventListener('mousemove', handleWindowMouseMove);
  }, []);
  // ...

C’est dû au fait que lorsque nous mettons à jour une variable de l’état local, nous remplaçons sa valeur, alors qu’avec this.setState dans une classe, on fusionne les champs mis à jour dans l’objet.

Si la fusion automatique vous manque, vous pouvez écrire un Hook personnalisé useLegacyState qui fusionne les mises à jour de l’état local. Cependant, nous recommandons plutôt de séparer l’état local en de multiple variables d’état en se basant sur celles qui ont tendance à changer de valeur ensemble.

Par exemple, nous pourrions découper l’état local de notre composant en deux objets position et size, et toujours remplacer la position sans avoir besoin de fusionner :

function Box() {
  const [position, setPosition] = useState({ left: 0, top: 0 });  const [size, setSize] = useState({ width: 100, height: 100 });

  useEffect(() => {
    function handleWindowMouseMove(e) {
      setPosition({ left: e.pageX, top: e.pageY });    }
    // ...

Séparer les variables d’état indépendantes présente un intérêt supplémentaire : il devient facile d’extraire une partie de la logique dans un Hook personnalisé, par exemple :

function Box() {
  const position = useWindowPosition();  const [size, setSize] = useState({ width: 100, height: 100 });
  // ...
}

function useWindowPosition() {  const [position, setPosition] = useState({ left: 0, top: 0 });
  useEffect(() => {
    // ...
  }, []);
  return position;
}

Remarquez comme nous avons pu déplacer l’appel à useState pour la variable d’état local position et l’effet associé dans un Hook personnalisé sans rien changer au code. Si tout l’état local était un unique objet, extraire cet aspect aurait été plus difficile.

Les deux approches sont possibles : mettre tout l’état local dans un unique appel à useState ou avoir un appel à useState par champ. La lisibilité des composants sera fonction de l’équilibre que vous trouverez entre ces deux extrêmes, et du regroupement des états locaux associés en quelques variables d’état indépendantes. Si la logique de l’état local devient trop complexe, nous vous conseillons de plutôt la gérer avec un réducteur ou un Hook personnalisé.

Puis-je exécuter un effet seulement lors des mises à jour ?

C’est un cas d’utilisation assez rare. Si vous en avez besoin, vous pouvez utiliser une ref modifiable pour stocker manuellement un booléen indiquant si vous êtes sur le premier rendu ou un rendu postérieur, et vérifier ensuite ce drapeau dans votre effet. (Si vous faites ça régulièrement, vous voudrez sans doute créer un Hook personnalisé pour ça.)

Comment récupérer les props ou l’état local précédents ?

Actuellement, vous pouvez le faire manuellement avec une ref :

Sometimes, you need previous props to clean up an effect. For example, you might have an effect that subscribes to a socket based on the userId prop. If the userId prop changes, you want to unsubscribe from the previous userId and subscribe to the next one. You don’t need to do anything special for this to work:

const prevCountRef = useRef(); useEffect(() => { prevCountRef.current = count; }); const prevCount = prevCountRef.current;

return

Maintenant : {count}, avant : {prevCount}

Ça peut sembler un peu biscornu mais vous pouvez l'extraire dans un Hook personnalisé :

```js{3,7}
function Counter() {
  const [count, setCount] = useState(0);
  const prevCount = usePrevious(count);
  return <h1>Maintenant : {count}, avant : {prevCount}</h1>;
}

function usePrevious(value) {
  const ref = useRef();
  useEffect(() => {
    ref.current = value;
  });
  return ref.current;
}

Remaquez que ça fonctionne pour les props, l’état local, et toute autre valeur calculée.

function Counter() {
  const [count, setCount] = useState(0);

  const calculation = count + 100;
  const prevCalculation = usePrevious(calculation);  // ...

Il est possible qu’à l’avenir React fournisse un Hook usePrevious prêt à l’emploi, puisque c’est un cas d’usage assez fréquent.

Voir aussi l’approche recommandée pour un état local dérivé.

Pourquoi vois-je des props ou un état local obsolètes dans ma fonction ?

Toute fonction au sein d’un composant, y compris les gestionnaires d’événements et les effets, « voit » les props et l’état local en vigueur lors du rendu qui les a créées. Par exemple, prenez ce genre de code :

function Example() {
  const [count, setCount] = useState(0);

  function handleAlertClick() {
    setTimeout(() => {
      alert('Vous avez cliqué à ' + count);
    }, 3000);
  }

  return (
    <div>
      <p>Vous avez cliqué {count} fois</p>
      <button onClick={() => setCount(count + 1)}>
        Cliquez ici
      </button>
      <button onClick={handleAlertClick}>
        Afficher un message
      </button>
    </div>
  );
}

Si vous cliquez d’abord sur « Afficher un message » puis incrémentez tout de suite le compteur, le message affichera la variable count telle qu’elle était lors du clic sur le bouton « Afficher un message ». Ça évite les bugs causés par du code qui suppose que les props et l’état local ne changent pas.

Si vous souhaitez explicitement lire le tout dernier état depuis une fonction de rappel asynchrone, vous pouvez le conserver dans une ref, la modifier puis la relire.

Pour finir, une autre explication possible pour vos props ou votre état périmés résiderait dans votre utilisation incorrecte de l’optimisation du hook par « tableau de dépendances », auquel il manquerait certaines valeurs. Par exemple, si un effet indique [] comme deuxième argument mais lit someProp en interne, il continuera à « voir » la valeur initiale de someProp. La solution consiste soit à retirer l’argument de tableau de dépendances, soit à le corriger. Voici comment y gérer des fonctions ainsi que d’autres stratégies habituelles pour exécuter des effets moins souvent sans ignorer à tort des dépendances.

Remarque

Nous proposons une règle ESLint exhaustive-deps dans le cadre du module eslint-plugin-react-hooks. Elle vous avertit lorsque les dépendances spécifiées semblent incorrectes et vous propose un correctif.

Comment puis-je implémenter getDerivedStateFromProps ?

Même si vous n’en avez probablement pas besoin, dans les rares cas où c’est nécessaire (comme implémenter un composant <Transition>) vous pouvez mettre à jour l’état local en plein rendu. React va rafraîchir le composant avec l’état local mis à jour immédiatement après être sorti du premier rendu afin que ça ne soit pas trop coûteux.

Ici, nous stockons la valeur précédente de la prop row dans une variable de l’état local afin que nous puissions les comparer :

function ScrollView({row}) {
  const [isScrollingDown, setIsScrollingDown] = useState(false);
  const [prevRow, setPrevRow] = useState(null);

  if (row !== prevRow) {
    // Row a changé depuis le dernier rendu. Met à jour isScrollingDown.
    setIsScrollingDown(prevRow !== null && row > prevRow);
    setPrevRow(row);
  }

  return `On défile vers le bas : ${isScrollingDown}`;
}

Ça peut sembler étrange à première vue, mais getDerivedStateFromProps avait précisément été conçue pour des mises à jour pendant le rendu.

Existe-t-il un équivalent à forceUpdate ?

Les deux Hooks useState et useReducer abandonnent la mise à jour si la valeur suivante est la même que la valeur précédente. Modifier l’état local en place et appeler setState ne causera pas de rafraîchissement.

Généralement, vous ne devez pas modifier l’état local directement en React. Cependant, à titre d’échappatoire, vous pouvez maintenir un compteur incrémental pour forcer un rafraîchissement même si l’état local n’a pas changé :

  const [ignored, forceUpdate] = useReducer(x => x + 1, 0);

  function handleClick() {
    forceUpdate();
  }

Évitez autant que possible d’utiliser cette approche.

Puis-je créer une ref vers une fonction composant ?

Vous ne devriez pas en avoir besoin souvent, mais vous pouvez exposer quelques méthodes impératives à un composant parent avec le Hook useImperativeHandle.

Comment puis-je mesurer un nœud DOM ?

Une façon rudimentaire de mesurer la position ou les dimensions d’un nœud DOM consiste à utiliser une ref avec fonction de rappel. React appellera la fonction de rappel chaque fois que la ref est attachée à un nœud différent. Voici une petite démo :

function MeasureExample() {
  const [height, setHeight] = useState(0);

  const measuredRef = useCallback(node => {    if (node !== null) {      setHeight(node.getBoundingClientRect().height);    }  }, []);
  return (
    <>
      <h1 ref={measuredRef}>Bonjour, monde</h1>      <h2>L’en-tête ci-dessus fait {Math.round(height)}px de haut</h2>
    </>
  );
}

Nous avons évité useRef dans cet exemple parce qu’un objet ref ne nous notifie pas des changements de la valeur actuelle de la ref. Une ref avec fonction de rappel garantit que même si un composant enfant affiche ultérieurement le nœud DOM mesuré (ex. en réaction à un clic), nous serons quand même notifiés dans le composant parent et pourrons mettre les mesures à jour.

Remarquez que nous passons [] comme tableau de dépendances à useCallback. C’est pour nous assurer que notre ref à fonction de rappel ne change pas d’un rendu à l’autre, afin que React ne nous appelle pas pour rien.

Dans cet exemple, la ref avec fonction de rappel ne sera appelée que lors du montage et du démontage du composant, puisque le composant <h1> reste présent d’un rendu au suivant. Si vous souhaitez être notifié·e à chaque redimensionnement, vous voudrez peut-être utiliser ResizeObserver ou un Hook tiers basé dessus.

Si vous le souhaitez, vous pouvez extraire cette logique dans un Hook réutilisable :

function MeasureExample() {
  const [rect, ref] = useClientRect();  return (
    <>
      <h1 ref={ref}>Bonjour, monde</h1>
      {rect !== null &&
        <h2>L’en-tête ci-dessus fait {Math.round(rect.height)}px de haut</h2>
      }
    </>
  );
}

function useClientRect() {
  const [rect, setRect] = useState(null);
  const ref = useCallback(node => {
    if (node !== null) {
      setRect(node.getBoundingClientRect());
    }
  }, []);
  return [rect, ref];
}

Que signifie const [thing, setThing] = useState() ?

Si vous n’avez pas l’habitude de cette syntaxe, allez voir l’explication dans la documentation du Hook d’état.

Optimisations des performances

Puis-je sauter un effet lors des mises à jour ?

Oui. Reportez-vous au déclenchement conditionnel d’un effet. Remarquez qu’oublier de gérer des mises à jour est souvent source de bugs, ce qui explique pourquoi ce n’est pas le comportement par défaut.

Est-il acceptable d’omettre les fonctions du tableau de dépendances ?

En règle générale, non.

function Example({ someProp }) {
  function doSomething() {
    console.log(someProp);  }

  useEffect(() => {
    doSomething();
  }, []); // 🔴 Ce n’est pas fiable (ça appelle `doSomething` qui utilise `someProp`)}

Il n’est pas facile de se souvenir du détail des props et de l’état local utilisés par les fonctions hors de l’effet. C’est pourquoi vous voudrez généralement déclarer les fonctions dont votre effet a besoin à l’intérieur de celui-ci. Il devient alors facile de voir de quelles valeurs de la portée du composant dépend cet effet :

function Example({ someProp }) {
  useEffect(() => {
    function doSomething() {
      console.log(someProp);    }

    doSomething();
  }, [someProp]); // ✅ OK (notre effet n’utilise que `someProp`)}

Si après ça vous n’utilisez toujours pas de valeurs issues de la portée du composant, vous pouvez sans problème spécifier [] :

useEffect(() => {
  function doSomething() {
    console.log('bonjour');
  }

  doSomething();
}, []); // ✅ OK dans ce cas précis car nous n’utilisons *aucune* valeur de la portée du composant

Selon votre cas, vous trouverez quelques options supplémentaires plus bas dans cette page.

Remarque

Nous mettons à disposition la règle ESLint exhaustive-deps dans le cadre du module eslint-plugin-react-hooks. Elle vous aide à trouver les composants qui ne gèrent pas correctement les mises à jour.

Voyons en quoi c’est important.

Si vous précisez une liste de dépendances comme dernier argument de useEffect, useLayoutEffet, useMemo, useCallback, ou useImperativeHandle, cette liste doit inclure toutes les valeurs utilisées dans la fonction passée qui participent au flux de données de React. Ça inclut les props, l’état local, et toute valeur qui en découle.

Le seul cas pour lequel vous pouvez sereinement omettre une fonction de la liste des dépendances, c’est lorsque rien à l’intérieur (y compris dans les autres fonctions qu’elle appelle) ne référence les props, l’état local ou des valeurs qui en découlent. L’exemple suivant a ce problème :

function ProductPage({ productId }) {
  const [product, setProduct] = useState(null);

  async function fetchProduct() {
    const response = await fetch('http://myapi/product/' + productId); // Utilise la prop productId    const json = await response.json();
    setProduct(json);
  }

  useEffect(() => {
    fetchProduct();
  }, []); // 🔴 Erroné car `fetchProduct` utilise `productId`  // ...
}

Le correctif recommandé consiste à déplacer la fonction dans votre effet. Ça facilite le repérage des props et variables d’état que votre effet utilise, pour garantir qu’elles sont toutes déclarées :

function ProductPage({ productId }) {
  const [product, setProduct] = useState(null);

  useEffect(() => {
    // En déplaçant cette fonction dans l'effet, on voit clairement quelles valeurs il utilise.    async function fetchProduct() {      const response = await fetch('http://myapi/product/' + productId);      const json = await response.json();      setProduct(json);    }
    fetchProduct();
  }, [productId]); // ✅ Correct car notre effet n’utilise que `productId`  // ...
}

Ça permet aussi de gérer les réponses trop tardives grâce à des variables locales à l’effet :

  useEffect(() => {
    let ignore = false;    async function fetchProduct() {
      const response = await fetch('http://myapi/product/' + productId);
      const json = await response.json();
      if (!ignore) setProduct(json);    }

    fetchProduct();
    return () => { ignore = true };  }, [productId]);

Nous avons déplacé la fonction dans l’effet, donc cette variable n’a pas à figurer dans la liste des dépendances.

Astuce

Jetez un coup d’œil à cette petite démo et cet article (en anglais) pour en apprendre davantage sur le chargement de données distantes avec les Hooks.

Si pour une raison ou une autre vous ne pouvez pas déplacer la fonction dans l’effet, vous avez d’autres options :

• Vous pouvez essayer de déplacer la fonction hors du composant. Dans ce cas, vous êtes sûr·e qu’elle ne pourra pas référencer des props ou variables d’état, et qu’elle n’a donc pas besoin de figurer dans la liste des dépendances.
• Si la fonction que vous appelez est un calcul pur et qu’on peut sereinement l’appeler pendant le rendu, vous pouvez l’appeler plutôt hors de l’effet et faire dépendre l’effet de la valeur qu’elle renvoie.
• En dernier recours, vous pouvez ajouter une fonction aux dépendances de l’effet mais enrober sa définition dans un Hook useCallback. Ça garantit qu’elle ne changera pas à chaque rendu sauf si ses propres dépendances changent aussi :

function ProductPage({ productId }) {
  // ✅ Enrobe avec useCallback pour éviter de changer à chaque rendu  const fetchProduct = useCallback(() => {    // ... Fait un truc avec productId ...  }, [productId]); // ✅ Toutes les dépendances de useCallback sont spécifiées
  return <ProductDetails fetchProduct={fetchProduct} />;
}

function ProductDetails({ fetchProduct }) {
  useEffect(() => {
    fetchProduct();
  }, [fetchProduct]); // ✅ Toutes les dépendances de useEffect sont spécifiées
  // ...
}

Remarquez que dans cet exemple nous devons garder la fonction dans la liste des dépendances. On s’assure ainsi qu’une modification à la prop productId de ProductPage déclenchera automatiquement un nouveau chargement de données distantes dans le composant ProductDetails.

Que faire quand mes dépendances d’effet changent trop souvent ?

Il arrive que votre effet utilise un état qui change trop fréquemment. Vous pourriez alors être tenté·e d’omettre cet état de la liste des dépendances, mais ça engendre souvent des bugs :

function Counter() {
  const [count, setCount] = useState(0);

  useEffect(() => {
    const id = setInterval(() => {
      setCount(count + 1); // Cet effet dépend de l’état `count`    }, 1000);
    return () => clearInterval(id);
  }, []); // 🔴 Bug : `count` n’est pas listé comme dépendance
  return <h1>{count}</h1>;
}

La liste de dépendances vide, [], singifie que l’effet ne sera exécuté qu’une fois au montage du composant, et non à chaque rafraîchissement. Le problème vient du fait que dans la fonction de rappel passée à setInterval, la valeur de count ne va pas changer, car on a créé une fermeture lexicale (closure, NdT) avec count à 0, tel qu’elle était lorsque la fonction de rappel de l’effet s’est exécutée. À chaque seconde, cette fonction appelle setCount(0 + 1), de sorte que le compteur ne dépasse jamais 1.

On pourrait corriger le bug en spécifiant [count] comme liste de dépendances, mais ça réinitialiserait notre horloge à chaque modification. En pratique, chaque setInterval aurait une chance de s’exécuter avant d’être réinitialisé (comme pour un setTimeout). Ce n’est peut-être pas souhaitable. Pour corriger ça, nous pouvons utiliser la version basée fonction de setState. Elle nous permet d’indiquer comment l’état change, sans référencer l’état actuel :

function Counter() {
  const [count, setCount] = useState(0);

  useEffect(() => {
    const id = setInterval(() => {
      setCount(c => c + 1); // ✅ Ça ne dépend pas de la variable `count` issue de la portée    }, 1000);
    return () => clearInterval(id);
  }, []); // ✅ Notre effet n’utilise aucune variable issue de la portée du composant
  return <h1>{count}</h1>;
}

(L’identité de la fonction setCount est garantie stable, il est donc naturel de l’omettre.)

À présent, la fonction de rappel de setInterval est appelée une fois par seconde, mais à chaque fois l’appel interne à setCount peut utiliser une valeur à jour de count (appelée c dans la fonction de rappel ci-dessus).

Pour des cas plus complexes (comme lorsqu’un état dépend d’un autre état), essayez de déplacer la logique de mise à jour de l’état hors de l’effet avec le Hook useReducer. Cet article (en anglais) vous donne un exemple de cette approche. L’identité de la fonction dispatch fournie par useReducer est garantie stable, même si la fonction de réduction est déclarée dans le composant et lit ses props.

En dernier recours, si vous voulez quelque chose de similaire au this d’une classe, vous pouvez utiliser une ref pour stocker une donnée modifiable. Vous pouvez alors y écrire et la relire. Par exemple :

function Example(props) {
  // Garde les dernières props dans une ref.  const latestProps = useRef(props);  useEffect(() => {    latestProps.current = props;  });
  useEffect(() => {
    function tick() {
      // Lit les dernières props en vigueur      console.log(latestProps.current);    }

    const id = setInterval(tick, 1000);
    return () => clearInterval(id);
  }, []); // Cet effet n’est jamais ré-exécuté}

Ne faites ça que si vous n’avez pas pu trouver de meilleure solution, car se reposer sur des mutations rend les composants plus imprévisibles. Si vous n’arrivez pas à trouver une approche adaptée pour votre besoin, créez un ticket avec un exemple exécutable de code pour que nous puissions essayer de vous aider.

Comment puis-je implémenter shouldComponentUpdate ?

Vous pouvez enrober une fonction composant avec React.memo pour comparer superficiellement ses props :

const Button = React.memo((props) => {
  // votre composant
});

Ce n’est pas un Hook car ce n’est pas composable, alors que les Hooks le sont. React.memo est équivalent à PureComponent, mais ne compare que les props. (Vous pouvez aussi ajouter un second argument pour spécifier une fonction de comparaison personnalisée qui prendra en arguments les anciennes et nouvelles props. Si elle renvoie true, la mise à jour est évitée.)

React.memo ne compare pas l’état local car il n’y a pas d’unique objet d’état local à comparer. Mais vous pouvez rendre les descendants purs également, ou même optimiser les descendants individuellement avec useMemo.

Comment mémoïser les calculs ?

Le Hook useMemo vous permet de mettre en cache les calculs à travers les rendus en « se souvenant » du dernier calcul :

const memoizedValue = useMemo(() => computeExpensiveValue(a, b), [a, b]);

Ce code appelle computeExpensiveValue(a, b). Mais si les dépendances [a, b] n’ont pas changé depuis la dernière fois, useMemo saute le second appel et réutilise simplement la dernière valeur renvoyée.

Rappelez-vous que la fonction passée à useMemo s’exécute pendant le rendu. N‘y faites rien que vous ne feriez normalement pendant le rendu. Par exemple, les effets de bord sont du ressort de useEffect, pas de useMemo.

Vous pouvez vous appuyer sur useMemo pour les optimisations de performances, mais pas comme une garantie sémantique. À l’avenir, React pourrait très bien choisir « d’oublier » certaines valeurs préalablement mémoïsées et de les recalculer lors du rendu suivant, par exemple pour libérer de la mémoire pour les composants non visibles. Écrivez votre code de façon à ce qu’il fonctionne toujours sans useMemo, et ajoutez-le ensuite pour optimiser les performances. (Pour les rares cas où une valeur ne doit jamais être recalculée, vous pouvez l’initialiser paresseusement dans une ref.)

Vous pouvez aussi utiliser useMemo pour éviter le rafraîchissement coûteux d’un enfant :

function Parent({ a, b }) {
  // N’est rafraîchi que si `a` change :
  const child1 = useMemo(() => <Child1 a={a} />, [a]);
  // N’est rafraîchi que si `b` change :
  const child2 = useMemo(() => <Child2 b={b} />, [b]);
  return (
    <>
      {child1}
      {child2}
    </>
  )
}

Remarquez que cette approche ne fonctionne pas dans une boucle car les appels aux Hooks ne doivent pas être placés dans des boucles. Mais vous pouvez extraire la liste dans un composant à part, et appeler useMemo sur celui-ci.

Comment créer paresseusement des objets coûteux ?

useMemo vous permet de mémoïser un calcul coûteux si les dépendances sont les mêmes. Cependant, il n’est là que pour aider, et ne garantit pas que le calcul ne sera pas refait. Mais parfois vous devez vous assurer qu’un objet n’est créé qu’une seule fois.

Le principal cas d’utilisation concerne la création d’un état initial coûteux :

function Table(props) {
  // ⚠️ createRows() est appelée à chaque rendu
  const [rows, setRows] = useState(createRows(props.count));
  // ...
}

Pour éviter de recréer l’état initial ignoré, nous pouvons passer une fonction à useState :

function Table(props) {
  // ✅ createRows() n'est appelée qu'une seule fois
  const [rows, setRows] = useState(() => createRows(props.count));
  // ...
}

React n’appelera cette fonction que lors du premier rendu. Vous trouverez de plus amples détails dans l’API de référence de useState.

Vous pouvez aussi vouloir occasionnellement éviter de recréer la valeur initiale de useRef(). Par exemple, vous voulez peut-être vous assurer qu’une instance de classe impérative n’est créée qu’une seule fois :

function Image(props) {
  // ⚠️ IntersectionObserver est créé à chaque rendu
  const ref = useRef(new IntersectionObserver(onIntersect));
  // ...
}

useRef n’accepte pas un argument de fonction spécial comme pour useState. Au lieu de ça, vous pouvez écrire votre propre fonction qui la crée et la définit paresseusement :

function Image(props) {
  const ref = useRef(null);

  // ✅ IntersectionObserver est créé paresseusement une seule fois
  function getObserver() {
    if (ref.current === null) {
      ref.current = new IntersectionObserver(onIntersect);
    }
    return ref.current;
  }

  // Quand vous en avez besoin, appelez getObserver()
  // ...
}

Ça permet d’éviter de recréer un objet coûteux tant qu’il n’est pas nécessaire. Si vous utilisez Flow ou TypeScript, vous pouvez aussi donner à getObserver() un type non-nullable pour un typage plus fin.

La création de fonctions à la volée pendant le rendu ralentit-elle les Hooks ?

Non. Dans les navigateurs modernes, les performances brutes des fermetures lexicales comparées à celles des classes diffèrent peu, sauf dans des scénarios extrêmes.

Par ailleurs, gardez à l’esprit que la conception de Hooks est plus efficace pour deux raisons :

• Les Hooks permettent d’éviter une grande partie de la « graisse » amenée par les classes, comme le coût de la création d’instances et la liaison des gestionnaires d’événements dans le constructeur.
• Le code idiomatique utilisant des Hooks n’a pas besoin d’une imbrication profonde de composants qui prévaudrait dans des projets utilisant des composants d’ordre supérieur, des props de rendu et des contextes. Avec des arborescences plus petites, React a moins de travail à faire.

Traditionnellement, les problématiques de performance associées aux fonctions définies à la volée en React sont liées au fait que passer de nouvelles fonctions de rappel à chaque rendu empêche les optimisations basées sur shouldComponentUpdate dans les composants enfants. Les Hooks abordent ce problème sous trois angles.

• Le Hook useCallback vous permet de référencer la même fonction de rappel d’un rendu à l’autre afin que shouldComponentUpdate puisse continuer à fonctionner :

  // Ne changera pas sauf si `a` ou `b` change
  const memoizedCallback = useCallback(() => {  doSomething(a, b);
  }, [a, b]);

• Le Hook useMemo permet de contrôler plus facilement les mises à jour des enfants, réduisant le besoin de composants purs.
• Enfin, le Hook useReducer réduit le besoin de passer en profondeur des fonctions de rappel, comme expliqué ci-dessous.

Comment éviter de transmettre des fonctions de rappel ?

Nous nous sommes aperçu que la majorité des gens n’aiment pas passer des fonctions de rappel à travers chaque niveau de l’arborescence. Même si c’est plus explicite, ça fait franchement « plomberie ».

Dans de grandes arborescences de composants, nous conseillons plutôt de transmettre une fonction dispatch issue de useReducer via le contexte :

const TodosDispatch = React.createContext(null);

function TodosApp() {
  // Remarque : `dispatch` ne va pas changer d'un rendu à l'autre  const [todos, dispatch] = useReducer(todosReducer);
  return (
    <TodosDispatch.Provider value={dispatch}>
      <DeepTree todos={todos} />
    </TodosDispatch.Provider>
  );
}

N’importe quel enfant de l’arborescence de TodosApp peut utiliser la fonction dispatch pour remonter des actions à TodosApp :

function DeepChild(props) {
  // Si nous voulons exécuter une action, nous pouvons récupérer dispatch depuis le contexte.  const dispatch = useContext(TodosDispatch);
  function handleClick() {
    dispatch({ type: 'add', text: 'salut' });
  }

  return (
    <button onClick={handleClick}>Ajouter une tâche</button>
  );
}

C’est à la fois plus pratique d’un point de vue maintenance (pas besoin de continuer à passer des fonctions de rappel), et ça règle au passage le problème (de mémoïsation) des fonctions de rappel. Pour les mises à jour déclenchées en profondeur, nous conseillons de transmettre dispatch de cette façon.

Remarquez que vous pouvez toujours choisir de transmettre l’état applicatif comme props (plus explicite) ou comme contexte (plus pratique pour les mises à jour très profondes). Si vous utilisez le contexte pour transmettre également l’état local, utilisez deux types de contexte différents : la donnée de contexte dispatch ne changera jamais, donc les composants qui l’utilisent n’ont pas besoin de se rafraîchir à moins qu’ils n’aient aussi besoin de l’état applicatif.

Comment lire une valeur changeant fréquemment avec useCallback ?

Remarque

Nous recommandons de transmettre dispatch dans le contexte plutôt que des fonctions de rappel individuelles dans les props. L’approche ci-dessous n’est mentionnée que par souci d’exhaustivité et à titre d’échappatoire.

Dans de rares cas vous pourriez avoir besoin de mémoïser une fonction de rappel avec useCallback mais la mémoïsation ne fonctionne pas très bien parce que la fonction interne a tout de même trop souvent besoin d’être recréée. Si la fonction que vous mémoïsez est un gestionnaire d’événements et n’est pas utilisée pendant le rendu, vous pouvez utiliser une ref comme variable d’instance, et y stocker manuellement la dernière valeur renvoyée :

function Form() {
  const [text, updateText] = useState('');
  const textRef = useRef();

  useLayoutEffect(() => {
    textRef.current = text; // Écrit dans la ref  });

  const handleSubmit = useCallback(() => {
    const currentText = textRef.current; // Lit depuis la ref    alert(currentText);
  }, [textRef]); // Ne recrée pas handleSubmit comme `[text]` le ferait

  return (
    <>
      <input value={text} onChange={e => updateText(e.target.value)} />
      <ExpensiveTree onSubmit={handleSubmit} />
    </>
  );
}

C’est une approche un peu biscornue mais ça montre que vous pouvez faire cette optimisation en dernier ressort, si vous en avez vraiment besoin. Vous pouvez en masquer les détails dérangeants en l’extrayant dans un Hook personnalisé :

function Form() {
  const [text, updateText] = useState('');
  // Sera mémoïsé même si `text` change :
  const handleSubmit = useEventCallback(() => {    alert(text);
  }, [text]);

  return (
    <>
      <input value={text} onChange={e => updateText(e.target.value)} />
      <ExpensiveTree onSubmit={handleSubmit} />
    </>
  );
}

function useEventCallback(fn, dependencies) {  const ref = useRef(() => {
    throw new Error('Cannot call an event handler while rendering.');
  });

  useEffect(() => {
    ref.current = fn;
  }, [fn, ...dependencies]);

  return useCallback(() => {
    const fn = ref.current;
    return fn();
  }, [ref]);
}

Dans les deux cas, nous déconseillons cette approche et ne l’illustrons ici que dans un souci d’exhaustivité. Au lieu de ça, il est préférable d’éviter de transmettre des fonctions de rappel en profondeur.

Sous le capot

Comment React associe-t-il les appels de Hooks avec les composants ?

React garde trace du composant en cours de rendu. Grâce aux règles des Hooks, nous savons que les Hooks sont uniquement appelés depuis des composants React (ou des Hooks personnalisés, qui sont aussi uniquement appelés depuis des composants React).

Il existe une liste interne de « cellules mémoire » associées à chaque composant. Ce sont juste des objets JavaScript où nous stockons quelques données. Quand vous appelez un Hook tel que useState(), il lit la cellule courante (ou l’initialise pendant le premier rendu), et déplace alors le pointeur sur la prochaine. C’est ainsi que de multiples appels à useState() peuvent avoir chacun un état local distinct.

Quelles sont les sources d’inspiration des Hooks ?

Les Hooks font la synthèse d’idées issues de plusieurs sources :

• Nos précédentes expériences autour d’API fonctionnelles dans le dépôt react-future.
• Les expériences de la communauté React avec les API de props de rendu, notamment le composant Reactions de Ryan Florence.
• La proposition de mot-clé adopt de Dominic Gannaway comme sucre syntaxique pour les props de rendu.
• Les variables d’état et les cellules à état en DisplayScript.
• Les composants réducteurs de ReasonReact.
• Les abonnements (Subscriptions, NdT) en Rx.
• Les effets algébriques de OCaml Multicore.

Sebastian Markbåge a proposé la conception initiale des Hooks, peaufinée ensuite par Andrew Clark, Sophie Alpert, Dominic Gannaway et d’autres membres de l’équipe React.