7. Watchers: watch vs watchEffect, Reactividad Profunda y Limpieza (onCleanup)
Ejecuta efectos secundarios asíncronos ante cambios de estado: observa fuentes explícitas con watch (deep e immediate) o rastrea dependencias automáticamente con watchEffect y gestiona cancelaciones.
Efectos Secundarios Controlados: Observadores en Vue 3
Mientras que computed() se utiliza para calcular valores puros sincrónicos, los Watchers están diseñados para reaccionar ante cambios de estado ejecutando efectos secundarios (side effects): llamadas a APIs remotas (fetch), operaciones en localStorage, manipulación manual del DOM o temporizadores.
1. watch(): Observación Explícita y Precisa
watch() es perezoso (lazy) por defecto: solo se ejecuta cuando la fuente observada cambia por primera vez después del montaje inicial. Recibe el nuevo valor y el valor anterior:
- Observar un ref:
watch(contador, (nuevo, viejo) => { ... }) - Observar una propiedad de reactive (requiere getter):
watch(() => usuario.edad, (nuevo) => { ... }) - Observar múltiples fuentes:
watch([id, filtro], ([nuevoId, nuevoFiltro]) => { ... }) - Opciones avanzadas:
immediate: true: Ejecuta el callback inmediatamente al inicializar el componente.deep: true: Fuerza la inspección profunda de objetos anidados.
2. watchEffect(): Rastreo Automático de Dependencias
A diferencia de watch(), watchEffect() se ejecuta inmediatamente y rastrea automáticamente cada variable reactiva que leas dentro de su función:
// Se ejecuta al inicio y cada vez que cambia 'userId' o 'categoria'
watchEffect(() => {
console.log(`Cargando datos para usuario ${userId.value} en categoría ${categoria.value}`);
});
3. Limpieza de Efectos con onCleanup / onWatcherCleanup
Cuando un usuario escribe rápido en un buscador, o el componente cambia de vista antes de que una petición HTTP termine, se corre el riesgo de condiciones de carrera (race conditions). Vue provee la función onCleanup para cancelar peticiones pendientes o temporizadores antes del siguiente ciclo:
watch(criterioBusqueda, (nuevoTexto, _, onCleanup) => {
const controller = new AbortController();
fetch(`/api/buscar?q=${nuevoTexto}`, { signal: controller.signal })
.then(r => r.json())
.then(data => resultados.value = data);
// Si criterioBusqueda vuelve a cambiar antes de terminar el fetch:
onCleanup(() => {
controller.abort(); // Cancela la petición anterior
});
});
⚡ Buscador Asíncrono con watch() y Temporizador de Limpieza (Debounce)
Observador reactivo con cancelación de búsquedas previas para evitar saturación de red.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>watch y watchEffect en Vue 3</title>
<link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="p-4 bg-light">
<div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 500px;">
<h5 class="fw-bold text-success mb-3">Buscador con watch() y onCleanup</h5>
<div class="mb-3">
<label class="form-label small text-muted">Escribe para buscar (Simula API remota):</label>
<input type="text" v-model="termino" class="form-control" placeholder="Ej: vue, pinia, react...">
</div>
<!-- Indicador de carga -->
<div v-if="cargando" class="text-primary mb-2 small d-flex align-items-center gap-2">
<div class="spinner-border spinner-border-sm" role="status"></div>
Consultando servidor (esperando 400ms debounce)...
</div>
<!-- Resultados -->
<ul v-if="resultados.length > 0" class="list-group mb-3">
<li v-for="res in resultados" :key="res" class="list-group-item list-group-item-action">
🔍 {{ res }}
</li>
</ul>
<div v-else-if="!cargando && termino" class="alert alert-warning py-2 small mb-3">
No se encontraron resultados para "{{ termino }}".
</div>
<div class="p-2 bg-light rounded border small text-secondary">
<strong>Historial del Watcher:</strong>
<div class="mt-1 font-monospace">{{ registroActividad }}</div>
</div>
</div>
<script src="/assets/vendor/vue/vue.global.prod.js"></script>
<script>
if (!window.Vue) {
document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
}
</script>
<script>
const { createApp, ref, watch } = Vue;
createApp({
setup() {
const termino = ref('');
const resultados = ref([]);
const cargando = ref(false);
const registroActividad = ref('Sin búsquedas aún.');
const baseDatosSimulada = [
'Vue.js 3 Fundamentos',
'Vue Router 4 SPA',
'Pinia State Management',
'TypeScript con Vue 3',
'Vite Bundler Rápido',
'Tailwind CSS con Vue'
];
// Observador con limpieza de temporizador
watch(termino, (nuevoTermino, viejoTermino, onCleanup) => {
if (!nuevoTermino) {
resultados.value = [];
cargando.value = false;
registroActividad.value = 'Búsqueda vaciada.';
return;
}
cargando.value = true;
registroActividad.value = `Buscando "${nuevoTermino}" (Canceló anterior)...`;
// Simular debounce de 400ms:
const timer = setTimeout(() => {
resultados.value = baseDatosSimulada.filter(item =>
item.toLowerCase().includes(nuevoTermino.toLowerCase())
);
cargando.value = false;
registroActividad.value = `Búsqueda lista para "${nuevoTermino}".`;
}, 400);
// Si el usuario presiona otra tecla antes de los 400ms:
onCleanup(() => {
clearTimeout(timer);
});
});
return {
termino,
resultados,
cargando,
registroActividad
};
}
}).mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Para qué sirve el callback onCleanup proporcionado dentro del observador watch en Vue 3?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.