Formations — 1 037 leçons en français

Accueil › Vue.js › watch et watchEffect

watch et watchEffect

La réactivitédebutant

computed produit une valeur. watch fait quelque chose : appeler une API, écrire en stockage, journaliser, piloter une bibliothèque extérieure.

import { ref, watch, watchEffect } from 'vue'

const id = ref(1)

watch(id, async (nouveau, ancien) => {
  console.log(ancien, '→', nouveau)
  fiche.value = await charger(nouveau)
})

watch déclare sa source. Il ne part pas au moment de la création — sauf { immediate: true } — et il reçoit l'ancienne et la nouvelle valeur.

watchEffect déduit ses sources de ce qu'il lit, et s'exécute immédiatement.

watchEffect(() => {
  document.title = `${utilisateur.value.nom} — ${onglet.value}`
})
watch watchEffect
Sources déclarées déduites à l'exécution
Premier passage non, sauf immediate oui, toujours
Ancienne valeur fournie indisponible
Lisibilité des déclenchements explicite implicite

Choisissez watch quand vous savez ce qui doit déclencher l'action, et surtout quand vous avez besoin de l'ancienne valeur. Choisissez watchEffect pour une synchronisation courte dont toutes les lectures sont des dépendances légitimes.

Une source mal passée est l'erreur la plus courante : watch(etat.n, ...) transmet un nombre. Il faut une fonction d'accès, watch(() => etat.n, ...).

Les termes à connaître

watch

Un observateur à sources déclarées. Il ne s'exécute pas au départ, et reçoit l'ancienne et la nouvelle valeur.

watchEffect

Un observateur à sources déduites. Il s'exécute immédiatement, et suit tout ce qu'il a lu pendant cette exécution.

deep

L'option qui fait parcourir l'objet observé en profondeur, pour réagir aussi aux mutations internes. Coûteuse sur une grosse structure.

immediate

L'option qui exécute le rappel une première fois dès la création du watch, sans attendre un changement.

onCleanup

Le nettoyage enregistré dans le rappel. Il s'exécute avant la réexécution suivante et à l'arrêt — pour annuler une requête ou un minuteur.

Arrêt automatique

Un observateur créé pendant la mise en place d'un composant est arrêté au démontage. Créé ailleurs, il doit être arrêté à la main.

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.