Saltar al contenido
Iteradores y generadores

Iteración asíncrona

Lección 4 de 410 min4 ejercicios

Algunos datos no están todos listos al empezar: llegan de a poco. Las páginas de una API, las líneas de un archivo enorme, los mensajes de un chat. La iteración asíncrona junta dos ideas, el recorrido de los iteradores y la espera de las promesas, para recorrer esos datos como si fueran una lista.

for await…of

for await funciona como for...of, pero espera cada valor antes de seguir. Se usa dentro de una función async o en el nivel superior de un módulo:

const pedidos = [
  fetch("/api/pedido/1"),
  fetch("/api/pedido/2"),
];

for await (const respuesta of pedidos) {
  console.log(respuesta.status);
}

Recorre un iterable de promesas y te da cada resultado cuando está listo, en orden.

Generadores asíncronos

async function* es un generador que además puede usar await. Es la forma natural de producir datos que llegan de a poco:

async function* paginasDeUsuarios() {
  let pagina = 1;
  while (true) {
    const respuesta = await fetch(`/api/usuarios?pagina=${pagina}`);
    const { usuarios, hayMas } = await respuesta.json();
    yield* usuarios;            // entrega cada usuario de esta página
    if (!hayMas) return;
    pagina++;
  }
}

for await (const usuario of paginasDeUsuarios()) {
  console.log(usuario.nombre);
  if (usuario.nombre === "Eva") break;  // y deja de pedir páginas
}

Quien recorre no sabe nada de páginas: ve una sola secuencia de usuarios. Y como el generador es perezoso, solo se piden las páginas necesarias. El break detiene el generador, que ya no hace más peticiones.

Array.fromAsync (ES2026)

Cuando quieres todos los valores en un array, Array.fromAsync es el equivalente asíncrono de Array.from. Devuelve una promesa:

async function* numerosLentos() {
  for (let i = 1; i <= 3; i++) {
    await new Promise((r) => setTimeout(r, 100));
    yield i;
  }
}

const todos = await Array.fromAsync(numerosLentos());
console.log(todos);  // [ 1, 2, 3 ], unos 300 ms después

const dobles = await Array.fromAsync(numerosLentos(), (n) => n * 2);
console.log(dobles);

Igual que Array.from, acepta una función para transformar cada valor.

El protocolo por dentro

Un iterable asíncrono tiene un método bajo Symbol.asyncIterator (en lugar de Symbol.iterator), y el next() de su iterador devuelve una promesa de { value, done }:

const tresTics = {
  [Symbol.asyncIterator]() {
    let n = 0;
    return {
      next() {
        n++;
        return new Promise((resolver) => {
          setTimeout(() => resolver({ value: `tic ${n}`, done: n > 3 }), 100);
        });
      },
    };
  },
};

for await (const t of tresTics) console.log(t);

En la práctica, casi nunca lo escribirás a mano: un async function* lo hace por ti, igual que un generador normal reemplaza al protocolo iterable escrito a mano.

Resumen

  • for await...of recorre valores asíncronos y espera cada uno.
  • async function* produce valores con yield y puede esperar con await.
  • Ideal para datos paginados o que llegan de a poco: se piden solo los necesarios.
  • Array.fromAsync (ES2026) junta todos los valores en un array.
  • El protocolo usa Symbol.asyncIterator y un next() que devuelve promesas.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Valores que llegan con el tiempo

Elige una respuesta en cada pregunta.

  1. ¿Para qué sirve for await...of?

  2. ¿Qué es un generador asíncrono, async function*?

  3. ¿Qué hace Array.fromAsync(iterable) (ES2026)?

  4. ¿Qué clave usa un objeto para ser iterable de forma asíncrona?

Ordena la salida: Esperar cada valor

Un generador que tarda 100 ms en cada valor. Ojo con la última línea del archivo. Ordena lo que aparecería en la consola.

const esperar = (ms) => new Promise((r) => setTimeout(r, ms)); async function* tictac() {  for (let i = 1; i <= 2; i++) {    await esperar(100);    yield `tic ${i}`;  }} async function main() {  console.log("empieza");  for await (const t of tictac()) {    console.log(t);  }  const todos = await Array.fromAsync(tictac());  console.log(todos.length);} main();console.log("main ya se llamó");

Consola, de arriba abajo

  1. main ya se llamó
  2. tic 2
  3. empieza
  4. 2
  5. tic 1

Detective: Un for...of sobre valores asíncronos

Se querían mostrar las páginas de una API a medida que llegan. Encuentra la línea que falla y elige el arreglo.

Consola

items.js:8
for (const pagina of paginas()) {
                     ^

TypeError: paginas is not a function or its return value is not iterable

Paso 1: toca la línea de código que causa el error.

Laboratorio: Un generador con pausas

Escribe el generador asíncrono conPausa(lista, ms): entrega cada elemento después de una pausa.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Imprime a, b y c (pendiente)
  • Es un generador asíncrono (async function*) (pendiente)
  • Espera de verdad: dos elementos con 60 ms tardan al menos 110 ms (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.