15. TypeScript en Vue 3: Composition API, defineProps, defineEmits y Tipado de Refs
Aplica TypeScript en el frontend moderno con Vue 3: tipado de reactividad con ref<T> y reactive<T>, props complejas con interfaces genéricas y eventos fuertemente tipados.
Vue 3 Diseñado desde Cero para TypeScript
A diferencia de Vue 2, el núcleo de Vue 3 fue completamente reescrito en TypeScript. Gracias al bloque <script setup lang="ts">, ya no es necesario escribir declaraciones verbosas de tipos en tiempo de ejecución: puedes usar interfaces nativas de TypeScript directamente dentro de defineProps y defineEmits.
1. Tipado Puro con defineProps y defineEmits en <script setup>
En lugar del tipado basado en objetos de runtime (props: { nombre: String }), en Vue 3 usamos la declaración puramente basada en tipos:
const props = defineProps<Props>(): Valida las propiedades del componente mediante una interfaz de TypeScript sin sobrecarga de código.const emit = defineEmits<Emits>(): Tipa estrictamente los nombres de los eventos y la carga útil (payload) que el componente hijo emite al padre.
2. Reactividad Tipada: ref<T> y computed<T>
Aunque ref('texto') infiere automáticamente Ref<string>, cuando una variable reactiva inicia en null esperando datos de una llamada a una API (por ejemplo const usuario = ref<Usuario | null>(null)), el paso del genérico explícito es indispensable para que el template avise si intentas acceder a usuario.nombre sin verificar si es nulo.
⚡ Componente Vue 3 Profesional con <script setup lang="ts">
Patrón de props genéricas, emits fuertemente tipados y reactividad estricta.
<!-- ==========================================
ARCHIVO: src/components/TarjetaEstudiante.vue
========================================== -->
<script setup lang="ts">
import { ref, computed } from 'vue';
// 1. Interfaz de Datos de Dominio
export interface Estudiante {
id: number;
nombre: string;
email: string;
calificacion: number;
activo: boolean;
}
// 2. Definición de Props mediante Interfaz Genérica
interface Props {
estudiante: Estudiante;
modoCompacto?: boolean; // Prop opcional
}
// Valores por defecto con withDefaults (macro oficial del compilador de Vue)
const props = withDefaults(defineProps<Props>(), {
modoCompacto: false,
});
// 3. Tipado Estricto de Eventos Emitidos (defineEmits)
interface Emits {
(e: 'actualizarCalificacion', nuevoValor: number): void;
(e: 'eliminar', id: number): void;
}
const emit = defineEmits<Emits>();
// 4. Reactividad Fuertemente Tipada
const editando = ref<boolean>(false);
const nuevaCalificacion = ref<number>(props.estudiante.calificacion);
// 5. Propiedades Computadas con Inferencia de Retorno
const estadoAcademico = computed<'Aprobado' | 'Reprobado'>(() => {
return props.estudiante.calificacion >= 70 ? 'Aprobado' : 'Reprobado';
});
function guardarCambios() {
emit('actualizarCalificacion', nuevaCalificacion.value);
editando.value = false;
}
</script>
<template>
<div class="tarjeta-estudiante" :class="{ compacto: modoCompacto }">
<h3>{{ estudiante.nombre }}</h3>
<p>Email: {{ estudiante.email }}</p>
<p>Estado: <strong>{{ estadoAcademico }}</strong></p>
<div v-if="editando">
<input type="number" v-model.number="nuevaCalificacion" min="0" max="100" />
<button @click="guardarCambios">Guardar</button>
</div>
<div v-else>
<span>Nota: {{ estudiante.calificacion }}</span>
<button @click="editando = true">Editar</button>
</div>
</div>
</template>
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lecciónEn Vue 3 con <script setup lang="ts">, ¿cuál es la ventaja de usar la sintaxis genérica defineProps<Props>() frente a las declaraciones tradicionales de props con objetos de JavaScript?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar TypeScript Profesional: Tipado Estático & Arquitectura Frontend/Backend 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.