Patrón Iterator: cambia la paginación de tu API sin romper 5 sitios
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
breakal 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
fetchPagefalso 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.