5. ref vs reactive: Diferencias, Unwrap Automático y Buenas Prácticas
Aprende cuándo utilizar ref (con su propiedad .value) para primitivos y objetos, frente a reactive, evitando la pérdida de reactividad al destructurar mediante toRefs y toRef.
Las Dos Primitivas Centrales de Reactividad: ref y reactive
En la Composition API de Vue 3, existen dos funciones principales para crear estado reactivo: ref() y reactive(). Aunque ambas crean fuentes de datos observables, su funcionamiento interno y reglas de uso en JavaScript determinan la limpieza y solidez de tu arquitectura.
1. ref(): Para Primitivos y Referencias Reasignables
En JavaScript nativo, los tipos primitivos (number, string, boolean, null, undefined) se pasan por valor, no por referencia. Un Proxy de ES6 sólo puede envolver objetos, no primitivos directos. Para solucionar esto, ref() envuelve el valor en un objeto contenedor con una propiedad .value:
- En JavaScript: Debes acceder y modificar siempre mediante
.value(ej:contador.value++). - En la Plantilla (<template>): Vue realiza un unwrap automático; puedes escribir directamente
{{ contador }}sin usar.value. - Acepta cualquier tipo: Puede almacenar tanto primitivos como objetos o arrays completos, permitiendo reasignar el objeto entero sin perder la reactividad:
usuario.value = nuevoObjeto.
2. reactive(): Para Objetos Complejos
reactive() envuelve directamente un objeto o array en un Proxy de ES6. No utiliza .value, por lo que el acceso a sus propiedades es idéntico al de un objeto JavaScript plano:
const perfil = reactive({
nombre: 'Carlos',
edad: 28
});
// Mutación directa:
perfil.edad = 29;
3. El Gran Peligro de reactive: Pérdida de Reactividad al Destructurar
¿Por qué destructurar un reactive rompe la reactividad?
Si haces const { nombre, edad } = perfil;, nombre y edad se convierten en variables JavaScript independientes con valores estáticos desconectadas del Proxy de Vue.
Solución oficial: toRefs() y toRef(): Convierte cada propiedad del objeto reactivo en un ref conectado a la fuente original:
import { reactive, toRefs } from 'vue';
const estado = reactive({ contador: 0, activo: true });
// ¡Totalmente seguro! Mantiene la reactividad bidireccional:
const { contador, activo } = toRefs(estado);
⚡ Comparativa Práctica: ref(), reactive() y toRefs() en Acción
Demostración de unwrap automático y preservación de reactividad tras destructurar.
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8">
<title>ref vs reactive 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: 520px;">
<h5 class="fw-bold text-success mb-3">Primitivas: ref() vs reactive()</h5>
<!-- Caja ref -->
<div class="p-3 bg-white border rounded mb-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="badge bg-primary mb-1">ref()</span>
<h6 class="mb-0">Puntuación: {{ puntuacion }}</h6>
</div>
<button @click="aumentarPuntuacion" class="btn btn-sm btn-primary">+1 (via .value)</button>
</div>
</div>
<!-- Caja reactive con toRefs -->
<div class="p-3 bg-white border rounded mb-3">
<span class="badge bg-success mb-1">reactive() + toRefs()</span>
<h6 class="mb-1">Usuario: {{ nombre }}</h6>
<p class="text-muted small mb-2">Rol: {{ rol }} | Nivel: {{ nivel }}</p>
<div class="d-flex gap-2">
<button @click="subirNivel" class="btn btn-sm btn-success">Subir Nivel</button>
<button @click="cambiarNombre" class="btn btn-sm btn-outline-secondary">Cambiar Nombre</button>
</div>
</div>
<div class="alert alert-secondary py-2 small mb-0">
💡 Nota cómo en el HTML nunca escribimos <code>.value</code> gracias al unwrap automático de Vue.
</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, reactive, toRefs } = Vue;
createApp({
setup() {
// 1. ref para valor primitivo
const puntuacion = ref(100);
const aumentarPuntuacion = () => {
// Requiere .value en JavaScript:
puntuacion.value += 10;
};
// 2. reactive para objeto
const usuario = reactive({
nombre: 'David Amador',
rol: 'Arquitecto Frontend',
nivel: 1
});
const subirNivel = () => {
usuario.nivel++;
};
const cambiarNombre = () => {
usuario.nombre = usuario.nombre === 'David Amador' ? 'Elena Morales' : 'David Amador';
};
// 3. toRefs para permitir destructuración segura sin perder reactividad
return {
puntuacion,
aumentarPuntuacion,
...toRefs(usuario),
subirNivel,
cambiarNombre
};
}
}).mount('#app');
</script>
</body>
</html>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué ocurre si desestructuras directamente un objeto reactive({ x: 1, y: 2 }) con "const { x } = obj;" 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.