12. Genéricos Fundamentales: Funciones, Interfaces y Clases Reutilizables (<T>)
Crea componentes y funciones de lógica universal capaces de trabajar con cualquier tipo manteniendo una seguridad estricta de compilación sin recurrir a any.
Genéricos: Parámetros de Tipo en TypeScript
En programación tradicional, si quieres que una función acepte cualquier tipo, la tentación inmediata es usar any. Sin embargo, al usar any pierdes toda la información de tipo de lo que entra y lo que sale. Los Genéricos (<T>) son variables de tipo que capturan el tipo exacto que el usuario envía y lo preservan en el retorno.
Figura 12.1: Modelado de componentes y transformación de contratos a partir de tipos genéricos.
1. Anatomía de una Función Genérica
El símbolo <T> (por convención "Type", aunque puedes usar cualquier identificador descriptivo) actúa como un comodín fuertemente tipado:
return [elemento];
}
Si pasas un string, TypeScript infiere que T es string y deduce que el retorno es string[], manteniendo el autocompletado en el array resultante.
⚡ Funciones, Interfaces y Clases Genéricas en la Práctica
Estructura de respuesta de API genérica y cola de procesamiento Type-Safe.
// ==========================================
// 1. INTERFAZ GENÉRICA PARA RESPUESTAS DE API
// ==========================================
export interface ApiResponse<TData> {
success: boolean;
timestamp: string;
data: TData; // El tipo de los datos cambia según el endpoint
error?: string;
}
// Entidades de dominio
interface Usuario {
id: number;
nombre: string;
email: string;
}
interface Producto {
sku: string;
precio: number;
}
// Uso con autocompletado total según el genérico suministrado:
const respuestaUsuario: ApiResponse<Usuario> = {
success: true,
timestamp: new Date().toISOString(),
data: { id: 101, nombre: 'Valentina', email: '[email protected]' },
};
const respuestaCatalogo: ApiResponse<Producto[]> = {
success: true,
timestamp: new Date().toISOString(),
data: [
{ sku: 'LAP-001', precio: 1200 },
{ sku: 'MOU-002', precio: 45 },
],
};
console.log(respuestaUsuario.data.email);
console.log(respuestaCatalogo.data[0].precio);
// ==========================================
// 2. CLASE GENÉRICA (COLA FIFO TYPE-SAFE)
// ==========================================
export class Cola<TElemento> {
private elementos: TElemento[] = [];
encolar(item: TElemento): void {
this.elementos.push(item);
}
desencolar(): TElemento | undefined {
return this.elementos.shift();
}
longitud(): number {
return this.elementos.length;
}
}
const colaPedidos = new Cola<number>();
colaPedidos.encolar(5001);
colaPedidos.encolar(5002);
console.log(`Procesando pedido: ${colaPedidos.desencolar()}`);
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la diferencia fundamental entre utilizar un tipo genérico <T> y utilizar el tipo any en una función?
¿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.