Back to the blog

This article is only available in Spanish.

Patrón Iterator: cambia la paginación de tu API sin romper 5 sitios

Series: Design Patterns

Tienes cinco sitios que recorren los pedidos de una API paginada. Todos repiten el mismo bucle: pedir página, mirar si hay más, pedir la siguiente. El día que la API cambia de page/totalPages a un cursor, se rompen los cinco.

El problema no es la API: es que todo el que recorre los datos sabe cómo se pagina.

El patrón

El patrón Iterator separa recorrer de cómo se obtienen los elementos. En JavaScript y TypeScript lo tienes en el lenguaje: un generador async.

type Order = { id: string; total: number };
type Page = { items: Order[]; nextCursor: string | null };

export async function* orders(fetchPage: (cursor: string | null) => Promise<Page>) {
  let cursor: string | null = null;
  do {
    const page = await fetchPage(cursor);
    yield* page.items;
    cursor = page.nextCursor;
  } while (cursor);
}

Quien consume ya no ve páginas, solo pedidos:

for await (const order of orders(api.getOrders)) {
  if (order.total > 1000) notify(order);
}

Si mañana la API vuelve a cambiar de paginación, cambias orders() y los cinco sitios siguen funcionando.

Ventajas que salen gratis

  • Carga perezosa: solo pide la siguiente página cuando el bucle la necesita. Si haces break al encontrar lo que buscas, no se piden más.
  • Un único sitio para reintentos, caché o límites de peticiones.
  • Tests sencillos: le pasas un fetchPage falso que devuelve páginas en memoria.

Cuándo no usarlo

  • Si necesitas saltar a la página 7 directamente (una tabla con paginador visible), un iterador secuencial no encaja: expón la página.
  • Si siempre necesitas todos los datos a la vez y son pocos, un getAll() que devuelva un array es más simple de leer.