Tema 7 · Efectos Secundarios & Watchers

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.

index.html
Solo lectura
<!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>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.