Tema 9 · Funciones & Overloads

9. Tipado Avanzado de Funciones: Parámetros Opcionales, Rest y Sobrecargas (Overloads)

Declara firmas de funciones robustas, maneja parámetros por defecto y empaquetados con rest (...args), y define múltiples firmas de llamada mediante sobrecargas tipadas.

Funciones de Primera Clase Fuertemente Tipadas

En JavaScript, las funciones son extraordinariamente flexibles: pueden recibir cualquier número de argumentos de tipos mixtos y retornar tipos dispares según la lógica interna. TypeScript te permite documentar y blindar esta flexibilidad mediante tipos de funciones, parámetros rest tipados y sobrecargas de funciones (Function Overloads).

1. Tipado de Funciones como Valores (Callback Signatures)

Puedes declarar el tipo de una función usando la sintaxis de flecha: type Notificador = (mensaje: string, nivel: number) => boolean;. Cualquier función que se pase como callback a ese parámetro deberá cumplir exactamente con esa firma.

2. Sobrecargas de Funciones (Function Overloads)

A veces una función retorna un tipo de dato diferente dependiendo del tipo de argumento que reciba. Por ejemplo, si pasas un string como fecha retorna un Date, pero si pasas un timestamp number retorna un string formateado. Las sobrecargas permiten declarar múltiples firmas públicas visibles antes de la función de implementación.

⚡ Sobrecargas de Funciones y Parámetros Rest Tipados

Definición de firmas múltiples con implementación unificada y type safety.

functionOverloads.ts
Solo lectura
// ==========================================
// 1. SOBRECARGA DE FUNCIONES (FUNCTION OVERLOADS)
// ==========================================

// Firma 1: Si recibe un string, devuelve un objeto Date
function formatearFecha(entrada: string): Date;

// Firma 2: Si recibe un timestamp number, devuelve un string con formato legible
function formatearFecha(entrada: number, formato?: 'corto' | 'largo'): string;

// Firma de Implementación (Visible sólo internamente; unifica los tipos anteriores)
function formatearFecha(entrada: string | number, formato: 'corto' | 'largo' = 'corto'): Date | string {
  if (typeof entrada === 'string') {
    return new Date(entrada);
  }
  
  const fecha = new Date(entrada);
  return formato === 'largo'
    ? fecha.toLocaleDateString('es-ES', { dateStyle: 'full' })
    : fecha.toISOString();
}

// Pruebas con inferencia exacta de retorno en el IDE:
const fechaObjeto = formatearFecha('2026-11-21'); // TypeScript sabe que es Date
const fechaTexto = formatearFecha(Date.now(), 'largo'); // TypeScript sabe que es string

console.log(fechaObjeto.getFullYear());
console.log(fechaTexto);

// ==========================================
// 2. PARÁMETROS REST TIPADOS
// ==========================================
function sumarPuntajes(estudiante: string, ...puntajes: number[]): string {
  const total = puntajes.reduce((acc, curr) => acc + curr, 0);
  return `Estudiante: ${estudiante} | Total: ${total}`;
}

const reporte = sumarPuntajes('Carlos', 95, 88, 100, 92);
console.log(reporte);
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
En el mecanismo de sobrecarga de funciones (Function Overloads) de TypeScript, ¿cuáles son las firmas visibles para el código que invoca la 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.

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