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.
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.