Tema 6 · interface vs type

6. interface vs type: Comparativa, Herencia (extends) y Declaration Merging

Resuelve el eterno debate: cuándo utilizar interfaces y cuándo type aliases, cómo extender contratos y cómo funciona la fusión de declaraciones (Declaration Merging) en librerías.

El Gran Dilema: ¿Interface o Type Alias?

Tanto interface como type permiten describir la forma de objetos y funciones en TypeScript. Aunque en el 90% de los casos son intercambiables, existen diferencias estructurales fundamentales: las interfaces soportan extensión mediante herencia y fusión de declaraciones (Declaration Merging), mientras que los types pueden representar primitivos, uniones, tuplas y tipos calculados.

1. Matriz de Diferencias Clave

Capacidad interface type
Describir Objetos y Métodos Excelente (Sintaxis limpia tipo POO). Excelente.
Uniones e Intersecciones No puede representar uniones directas ('A' | 'B'). Nativo (type Estado = 'activo' | 'inactivo').
Extensión / Herencia Mediante extends (interface Admin extends Usuario). Mediante intersección & (type Admin = Usuario & { permisos: string[] }).
Declaration Merging (Fusión) Soportado: Dos interfaces con el mismo nombre fusionan sus campos automáticamente. Error TS2300: No se puede declarar el mismo type dos veces.
Rendimiento del Compilador Ligeramente más rápido en proyectos gigantes (el compilador cachea interfaces por nombre). Muy rápido, pero uniones masivas requieren más memoria en el checker.

2. Declaration Merging en el Mundo Real

¿Alguna vez te has preguntado cómo librerías como Express permiten agregar propiedades como req.user al objeto Request nativo? Se logra gracias al Declaration Merging de interfaces: abres la interfaz existente en tu archivo de definición y TypeScript une las propiedades sin tocar el paquete original en node_modules.

⚡ Herencia con extends, Intersecciones con & y Declaration Merging

Ejemplo exhaustivo de cuándo usar cada uno en desarrollo moderno.

interfaceVsType.ts
Solo lectura
// ==========================================
// 1. EXTENSIÓN CON INTERFACE (Patrón POO)
// ==========================================
interface Persona {
  id: number;
  nombre: string;
}

// Extensión limpia mediante extends
interface Empleado extends Persona {
  cargo: string;
  salario: number;
}

const dev: Empleado = {
  id: 1,
  nombre: 'Sofía Herrera',
  cargo: 'Senior TypeScript Engineer',
  salario: 4500,
};

// ==========================================
// 2. COMPOSICIÓN CON TYPE ALIAS (Uniones e Intersecciones)
// ==========================================
type Rol = 'admin' | 'editor' | 'lector'; // Exclusivo de type (uniones)
type Auditoria = {
  createdAt: Date;
  updatedAt: Date;
};

// Intersección con el operador &
type UsuarioAuditable = Persona & Auditoria & { rol: Rol };

const usuarioAuditado: UsuarioAuditable = {
  id: 10,
  nombre: 'Martín',
  rol: 'admin',
  createdAt: new Date(),
  updatedAt: new Date(),
};

// ==========================================
// 3. DECLARATION MERGING (Exclusivo de interfaces)
// ==========================================
interface VentanaConfig {
  ancho: number;
}

// Declarar la misma interfaz en otro archivo añade la nueva propiedad
interface VentanaConfig {
  alto: number;
}

// TypeScript fusionó ambas declaraciones en una sola interfaz
const pantalla: VentanaConfig = {
  ancho: 1920,
  alto: 1080,
};

console.log(`${dev.nombre} - ${dev.cargo} | Resolución: ${pantalla.ancho}x${pantalla.alto}`);
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
¿Qué característica exclusiva poseen las interfaces (interface) frente a los alias de tipo (type) en TypeScript?
🦉
¿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.