Dos palabras
asyncdelante de una función hace que siempre devuelva una promesa: si hacesreturn 5, quien la llama recibe una promesa de 5.awaitdelante de una promesa pausa la función hasta que la promesa se cumpla, y te da su valor.
const esperar = (ms, valor) => new Promise((r) => setTimeout(() => r(valor), ms));
async function prepararDesayuno() {
const cafe = await esperar(50, "café");
const tostada = await esperar(50, "tostada");
return `${cafe} y ${tostada}`;
}
prepararDesayuno().then((d) => console.log("listo:", d));
console.log("mientras, pongo la mesa");
await no bloquea el programa: mientras espera, la función sale de la pila, como un generador en un yield, y el event loop sigue con otras cosas. Cuando la promesa se cumple, la función retoma donde quedó, como una microtarea.
Errores con try/catch
Si la promesa se rechaza, await lanza el error, y se atrapa como cualquier otro:
const fallar = () => new Promise((_, mal) => setTimeout(() => mal(new Error("servidor caído")), 30));
async function cargar() {
try {
const datos = await fallar();
console.log(datos);
} catch (e) {
console.log("no se pudo cargar:", e.message);
} finally {
console.log("ocultar el «cargando…»");
}
}
cargar();
En serie o en paralelo
Cada await espera a que termine lo anterior. Si las tareas no dependen una de otra, esperarlas en fila es perder tiempo:
const esperar = (ms, valor) => new Promise((r) => setTimeout(() => r(valor), ms));
// En serie: unos 200 ms
let t = performance.now();
const a = await esperar(100, "perfil");
const b = await esperar(100, "amigos");
console.log("en serie:", Math.round(performance.now() - t), "ms");
// En paralelo: unos 100 ms
t = performance.now();
const [c, d] = await Promise.all([esperar(100, "perfil"), esperar(100, "amigos")]);
console.log("en paralelo:", Math.round(performance.now() - t), "ms");
La regla: await en serie cuando un paso necesita el resultado del anterior; Promise.all cuando son independientes.
await de nivel superior (ES2022)
En un módulo (los veremos en la próxima sección), puedes usar await fuera de cualquier función:
// configuracion.js, cargado como módulo
const respuesta = await fetch("/config.json");
export const config = await respuesta.json();
Los módulos que importen configuracion.js esperan a que termine antes de ejecutarse. Los ejemplos de esta página también lo usan: corren como si fueran un módulo.
Errores comunes
async function obtenerNumero() {
return 42;
}
// 1. Olvidar el await: obtienes la promesa, no el valor
const sinAwait = obtenerNumero();
console.log(sinAwait instanceof Promise); // true
// 2. await en un forEach: no espera a nadie (lo verás en Patrones)
// 3. Llamar a una función async y no manejar su rechazo:
// si falla, es un rechazo no manejado
const conAwait = await obtenerNumero();
console.log(conAwait);
Resumen
asynchace que la función devuelva siempre una promesa.awaitpausa la función, sin bloquear el programa, hasta que la promesa se cumpla.- Los rechazos se manejan con
try/catch/finally. awaitseguidos = en serie;await Promise.all([...])= en paralelo.- En los módulos hay
awaitde nivel superior (ES2022). - El error más común: olvidar el
awaity trabajar con la promesa en lugar del valor.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Promesas que se leen de arriba abajo
Resuelto
Elige una respuesta en cada pregunta.
¿Qué devuelve siempre una función
async?¿Qué hace
await?¿Cómo se manejan los errores con
await?Dos
awaitseguidos sobre tareas independientes de 1 segundo cada una, ¿cuánto tardan?
Ordena la salida: Dónde se pausa
Resuelto
Una función async con un solo await. Ordena lo que aparecería en la consola.
1async function preparar() {2 console.log("2. empieza preparar");3 await null;4 console.log("4. sigue después del await");5 return "listo";6}7 8console.log("1. antes");9preparar().then((v) => console.log("5.", v));10console.log("3. después de llamar");Consola, de arriba abajo
- 3. después de llamar
- 5. listo
- 1. antes
- 4. sigue después del await
- 2. empieza preparar
Una función async se ejecuta en el momento hasta el primer await. Ahí se pausa y devuelve su promesa: el programa sigue con la línea 10. Cuando la pila queda libre, la función retoma, termina y cumple su promesa.
Detective: Un await que falta
Resuelto
El usuario existe, pero su nombre no aparece. Encuentra la línea y elige el arreglo.
Consola
saludo.js:7
console.log(`Hola, ${usuario.nombre.toUpperCase()}`);
^
TypeError: Cannot read properties of undefined (reading 'toUpperCase')Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: De then a await
Resuelto
Reescribe cargarPerfil con async, await y try/catch.
$ node programa.js
Lo que debe cumplir
- Imprime
Perfil de Anaysin perfil(pendiente) - Sigue devolviendo una promesa con el resultado (pendiente)
- Usa
async,awaitytry/catch, sin.thenni.catch(pendiente)
Una solución
1const usuarios = { 1: "Ana", 2: "Luis" };2const buscarUsuario = (id) =>3 new Promise((ok, mal) =>4 setTimeout(() => (usuarios[id] ? ok(usuarios[id]) : mal(new Error("no existe"))), 20)5 );6 7async function cargarPerfil(id) {8 try {9 const nombre = await buscarUsuario(id);10 return `Perfil de ${nombre}`;11 } catch {12 return "sin perfil";13 }14}15 16console.log(await cargarPerfil(1));17console.log(await cargarPerfil(9));Hacen exactamente lo mismo, pero la versión con await se lee como código síncrono: un paso, el siguiente, y el error en su catch. Por debajo siguen siendo promesas.