Tema 15 · Vue 3 con TypeScript

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.

TarjetaEstudiante.vue
Solo lectura
<!-- ==========================================
     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ón
1 Pregunta
Pregunta 1
En 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.

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