TypeScript Academy · Lección

Gestión de errores en código TypeScript asíncrono

Gestione errores asíncronos con wrappers y utilidades tipados.

Lección 4 de 413 pasos

Gestión de errores en código TypeScript asíncrono es una lección gratuita de TypeScript Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de TypeScript Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de TypeScript Academy incluye 4 lecciones en total.

Bienvenida

Las funciones asíncronas añaden complejidad a la gestión de errores. TypeScript garantiza que gestione correctamente los rechazos de Promise.

Try-Catch con Async/Await

Incluya las llamadas await en un bloque try-catch para gestionar los rechazos de Promise.
async function loadUser(id: number): Promise<User> {
  try {
    return await api.getUser(id);
  } catch (err: unknown) {
    if (err instanceof Error) throw new AppError(err.message);
    throw new AppError('Unknown error');
  }
}

Errores de Promise.all

Promise.all se rechaza con el primer rechazo. Inclúyalo en un bloque try-catch.
try {
  const [user, posts] = await Promise.all([getUser(id), getPosts(id)]);
} catch (err) { /* one or both failed */ }

Promise.allSettled

allSettled devuelve tanto los resultados correctos como los errores sin lanzar excepciones.
const results = await Promise.allSettled([getUser(1), getPosts(1)]);
results.forEach(r => {
  if (r.status === 'fulfilled') console.log(r.value);
  else console.error(r.reason);
});

Resultado asíncrono tipado

Combine la asincronía con el patrón Result para gestionar los errores de forma explícita.
async function safeGet<T>(fn: () => Promise<T>): Promise<Result<T>> {
  try { return { ok: true, value: await fn() }; }
  catch (e) { return { ok: false, error: e as Error }; }
}

Rechazos no gestionados

Escuche los rechazos no gestionados en Node.js para evitar cierres inesperados.
process.on('unhandledRejection', (reason: unknown) => {
  console.error('Unhandled rejection:', reason);
  process.exit(1);
});

Tiempo de espera con Promise.race

Implemente un patrón de tiempo de espera tipado con Promise.race.
function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {
  const timeout = new Promise<never>((_, reject) =>
    setTimeout(() => reject(new Error('Timeout')), ms));
  return Promise.race([promise, timeout]);
}

Patrón de reintento

Implemente reintentos asíncronos tipados con errores tipados.
async function retry<T>(fn: () => Promise<T>, times: number): Promise<T> {
  for (let i = 0; i < times; i++) {
    try { return await fn(); } catch (e) { if (i === times - 1) throw e; }
  }
  throw new Error('Unreachable');
}

Gestión de errores concurrentes

Gestione los errores al ejecutar operaciones asíncronas concurrentes.
const [userResult, postsResult] = await Promise.allSettled([
  getUser(id).then(u => ({ ok: true, value: u })).catch(e => ({ ok: false, error: e })),
  getPosts(id).then(p => ({ ok: true, value: p })).catch(e => ({ ok: false, error: e })),
]);

Propagación de errores en AsyncQueue

Los errores de los iteradores asíncronos se propagan correctamente con for-await.
async function* generate() {
  yield await fetchA();
  yield await fetchB(); // error here stops the loop
}
for await (const item of generate()) { process(item); }

Middleware de errores tipados en Next.js

Use límites de error tipados en las acciones del servidor.
'use server';
async function createUser(data: CreateUserDto): Promise<Result<User>> {
  return safeGet(() => db.user.create({ data }));
}

Comprobación rápida

¿Qué ocurre si no captura una Promise rechazada en una función async/await?

Recapitulación

Gestión de errores en código TypeScript asíncrono: ha aprendido los conceptos clave de este tema y cómo aplicarlos en proyectos reales de TypeScript.
Gratis para empezar

Aprende TypeScript con un tutor de IA — gratis

Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.

Cursos
101
Lecciones
352

Preguntas frecuentes

¿La lección «Gestión de errores en código TypeScript asíncrono» es gratis?

Sí — el texto completo de «Gestión de errores en código TypeScript asíncrono» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de TypeScript Academy, actualiza a CoddyKit PRO. El curso de TypeScript Academy incluye 4 lecciones en total.

¿Qué aprenderé en «Gestión de errores en código TypeScript asíncrono»?

Gestione errores asíncronos con wrappers y utilidades tipados. Practicas TypeScript Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar TypeScript Academy?

No se requiere experiencia previa. TypeScript Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Gestión de errores en código TypeScript asíncrono»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de TypeScript Academy?

Sí. Cada lección de TypeScript Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Clases y jerarquías de errores tipadas
  2. El patrón Result: Ok y Err
  3. Reducción de errores capturados (unknown frente a Error)
  4. Gestión de errores en código TypeScript asíncrono
← Volver a TypeScript Academy