React et TypeScript
Placez l'état au même endroit
Chaque valeur doit avoir un seul propriétaire. La plupart des bugs React proviennent de deux copies d'un même fait qui divergent.
Dérivez plutôt que de stocker. Si une valeur peut être calculée à partir des props et de l'état pendant le rendu, calculez-la — ne la mettez pas en miroir dans useState, car la copie devient obsolète dès que sa source change. const total = items.reduce(...) n'a besoin d'aucun état et ne peut jamais être erroné.
Une état copié depuis une prop est le même bug avec une mèche plus longue : la valeur initiale de useState est lue une fois et ignorée pour toujours par la suite. Si le composant doit se réinitialiser lorsqu'une prop change, donnez-lui une key et laissez React le remonter.
Remontez l'état uniquement jusqu'au parent commun le plus proche qui en a besoin. Le remonter plus loin fait que chaque frère se re-rend à chaque frappe.
Effets
Un effet se synchronise avec quelque chose en dehors de React : un abonnement, une minuterie, le document, une bibliothèque impérative. Ce n'est pas l'endroit pour calculer des valeurs ou répondre à un clic — le gestionnaire d'événement l'est.
Le tableau de dépendances doit lister tout ce que l'effet lit. Omettre une valeur pour arrêter une boucle la fige à sa première valeur et produit le bug de fermeture obsolète. Si l'effet boucle parce qu'une dépendance est un objet ou une fonction reconstruit à chaque rendu, corrigez la dépendance — useCallback, useMemo, ou déplacez-la hors du composant — plutôt que de la supprimer du tableau.
Renvoie une fonction de nettoyage chaque fois que l'effet démarre quelque chose qui peut lui survivre. Les abonnements, minuteries et requêtes en vol doivent tous s'arrêter lorsque le composant se démonte ou que les dépendances changent, et sous le mode Strict en développement, l'effet s'exécute deux fois précisément pour exposer un nettoyage manquant.
Une fonction async ne peut pas être un corps d'effet — elle retourne une promesse, et React attend une fonction de nettoyage. Déclarez le travail asynchrone à l'intérieur et appelez-le.
Récupération de données
Préférez la bibliothèque de données du projet à une récupération artisanale dans un effet ; elle résout déjà la mise en cache, la déduplication, la nouvelle tentative et la condition de course que vous êtes sur le point d'écrire.
Lors de la récupération manuelle, gérez les quatre états — chargement, vide, erreur, succès — et annulez la requête lors du nettoyage. Deux requêtes démarrées dans l'ordre peuvent encore se résoudre dans le désordre, donc soit abandonnez la précédente, soit ignorez une réponse qui n'est plus actuelle.
N'avalez jamais un rejet. Un rejet non géré dans un gestionnaire ou un effet échoue silencieusement et l'interface arrête simplement de se mettre à jour.
Rendu
Cléfiez les listes avec une identité stable provenant des données. Les clés d'index ne sont correctes que pour une liste qui ne se réordonne, n'insère ni ne supprime jamais ; lorsqu'elle le fait, React réutilise le mauvais nœud DOM et les entrées conservent la valeur de la ligne précédente.
Utilisez memo, useMemo et useCallback après une mesure avec le profileur. Appliqués partout par défaut, ils ajoutent une allocation et des tableaux de dépendances qui se trompent, et ils ne résolvent rien quand le vrai coût est un parent qui re-rend tout l'arbre.
N'appelez jamais un hook conditionnellement, dans une boucle, ou après un retour précoce. L'ordre doit être identique à chaque rendu.
TypeScript
Considérez any et une assertion de type comme une question non résolue, pas une correction. Les deux font taire le compilateur exactement à l'endroit où il avait quelque chose d'utile à dire. Lorsqu'un type est véritablement inconnu, utilisez unknown et affinez-le.
Tapez ce qui traverse une frontière : réponses API, valeurs de formulaire, paramètres URL. Les données provenant du réseau ne sont pas du type que vous avez déclaré tant que quelque chose ne les vérifie pas, donc validez à la frontière et laissez le reste de l'application faire confiance au résultat.
Vérifiez
Une construction verte prouve moins qu'il n'y paraît. De nombreux projets configurent le framework pour ignorer les erreurs de lint et de type lors de la construction, alors vérifiez la configuration avant de considérer la construction comme une preuve, et exécutez la vérification de type et le linter explicitement.
Ensuite, utilisez le composant : l'état vide, l'état d'erreur, un réseau lent, et une deuxième interaction rapide avant que la première ne se termine.