Formations — 1 037 leçons en français

Accueil › Vue.js › Nettoyer ce qu'on a mis en place

Nettoyer ce qu'on a mis en place

Cycle de vie et effetsintermediaire

Un composant qui crée quelque chose hors de lui-même doit le détruire. Vue n'en sait rien : un setInterval, un addEventListener sur window, un ResizeObserver, un abonnement à une socket continuent de vivre après le démontage.

<script setup>
import { ref, onMounted, onUnmounted } from 'vue'

const largeur = ref(window.innerWidth)
function surRedimension() { largeur.value = window.innerWidth }

onMounted(() => window.addEventListener('resize', surRedimension))
onUnmounted(() => window.removeEventListener('resize', surRedimension))
</script>

La règle tient en un mot : symétrie. Chaque ligne de onMounted a sa ligne dans onUnmounted, et les deux crochets se touchent dans le fichier. Dès qu'ils s'éloignent, un ajout dans l'un finit par ne plus avoir d'écho dans l'autre.

Ce qui fuit en pratique : minuteurs, écouteurs globaux, observateurs du navigateur, abonnements à un bus ou à une connexion persistante, instances de bibliothèques tierces.

Ce qui ne fuit pas : les watch, watchEffect et computed créés pendant l'exécution synchrone de setup. Vue les regroupe dans une portée d'effet rattachée au composant et les arrête au démontage.

watch(source, rappel)                     // arrêté automatiquement
setTimeout(() => watch(source, rappel))   // jamais arrêté

La différence n'est pas le type d'effet, c'est le moment de sa création.

Les termes à connaître

Symétrie montage/démontage

La règle selon laquelle tout ce qui est créé dans onMounted doit être défait dans onUnmounted, au même endroit du fichier.

Fuite d'écouteur

Un écouteur d'événement, un minuteur ou un abonnement qui survit au composant qui l'a créé. Il continue de s'exécuter et retient en mémoire tout ce qu'il référence.

Portée d'effet

Le conteneur, créé par Vue autour de setup, qui regroupe les effets d'un composant pour les arrêter tous ensemble au démontage.

Fonction d'arrêt

La valeur renvoyée par watch et watchEffect. L'appeler arrête l'observateur avant le démontage.

onWatcherCleanup

Fonction de Vue 3.5 qui enregistre, depuis l'intérieur d'un rappel d'observateur, le nettoyage à exécuter avant la prochaine exécution ou à l'arrêt.

effectScope

Une portée d'effet créée à la main, pour regrouper des effets qui ne sont pas liés à un composant et les arrêter d'un seul appel.

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.