Tutorial de JavaScript

async y await en JavaScript, explicado fácil

Algunas cosas tardan: pedir datos a una API, esperar unos segundos. En lugar de congelar la página, JavaScript sigue trabajando y te avisa cuando terminan. Con async y await escribes ese código como si fuera en orden, línea por línea. Aquí verás cómo funciona con un ejemplo resuelto.

async y await: esperar como si fuera normal

await se escribe antes de una promesa y significa «espera a que se cumpla y dame su valor». En lugar de .then((p) => …), escribes const p = await buscarAlgo().

await solo funciona dentro de una función marcada con async. Esa función se pausa en cada await, pero el resto de la página sigue funcionando (no se congela).

Si la promesa falla, await LANZA el error. Por eso se combina con try y catch, que ya conoces: en try lo que esperas, en catch qué hacer si falla.

Cómo se escribe

async function cargar() { try { const dato = await buscarAlgo() console.log(dato) } catch (error) { console.log(error.message) } } cargar()

async function
una función que puede usar await adentro
await promesa
espera a que se cumpla y da su valor
try { } catch (error) { }
atrapa el error si una promesa falla
cargar()
crear la función no la corre: hay que llamarla

Ejemplo resuelto

script.js

function esperar(ms) {
  return new Promise((resolve) => setTimeout(resolve, ms))
}

async function entrenar() {
  console.log("Pikachu empieza a entrenar")
  await esperar(500)
  console.log("Pikachu subió al nivel 6")
  await esperar(500)
  console.log("Pikachu subió al nivel 7")
}

entrenar()
console.log("Mientras tanto, la Pokédex sigue funcionando")

Consola

Pikachu empieza a entrenar

Mientras tanto, la Pokédex sigue funcionando

Pikachu subió al nivel 6

Pikachu subió al nivel 7

Un juego de Pokémon: Pikachu entrena dos niveles, con una pausa entre cada uno, sin congelar el juego.

  • Sin await, buscarProducto(9) te da la promesa, no el producto: a.title sale undefined.
  • Usar await fuera de una función async es un error. Si ves ese aviso, revisa que la función tenga async delante.
  • async y await hacen lo mismo que then y catch, pero se leen más fácil cuando hay varios pasos seguidos. Vas a ver los dos estilos en código real.

Preguntas frecuentes

¿Dónde puedo usar await?

Dentro de una función marcada con async.

¿Qué devuelve una función async?

Siempre una promesa: para obtener su valor, usa await al llamarla.

¿Cómo atrapo errores con await?

Con try/catch alrededor de las líneas que esperan.