HOWTO · JavaScript
JavaScript asíncrono para cada uno
En la publicación de hoy, veremos cómo usar async en forEach de JavaScript.
En esta página
El método forEach de JavaScript llama a una callback para cada elemento del array, pero no espera las promesas que devuelve una callback async. Esta diferencia importa cuando el trabajo posterior depende de que terminen las callbacks. Usa for...of con await cuando cada operación deba terminar antes de que empiece la siguiente, o usa map con Promise.all cuando las operaciones independientes puedan ejecutarse de forma concurrente.
Ejecuta este ejemplo:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
async function doubleAll(values) {
const doubled = await Promise.all(values.map(async value => value * 2));
console.log(doubled.join(", "));
}
doubleAll([1, 2, 3]);
2, 4, 6
La callback async que se pasa a map devuelve una promesa por cada valor. Promise.all espera a que se resuelvan esas promesas y devuelve los resultados en el mismo orden que la entrada, aunque las operaciones terminen en otro orden.
Por qué forEach no espera a las callbacks asíncronas
forEach siempre devuelve undefined; no recopila los valores devueltos por las callbacks. Si marcas una callback como async, cada llamada devuelve una promesa, pero forEach ignora esas promesas. Por tanto, await values.forEach(...) espera el resultado inmediato undefined, pero no espera a que termine el trabajo de las callbacks. El código que sigue a esa expresión puede ejecutarse antes de que acaben las operaciones asíncronas.
La misma distinción se aplica a los errores: el rechazo de la promesa de una callback no se propaga a través de la llamada a forEach. Si necesitas esperar a que termine el trabajo o gestionar sus errores, elige una construcción que conserve las promesas. Usa forEach para efectos secundarios síncronos que no necesiten un resultado agregado ni una señal de finalización.
Ejecutar trabajo asíncrono secuencialmente con for...of
Usa for...of cuando el orden importe o cuando cada operación dependa del resultado anterior. Un await dentro del bucle detiene el avance de esa función hasta que se resuelva o rechace la operación actual; después, el bucle continúa. La función que contiene el bucle devuelve una promesa que se resuelve cuando termina el bucle, o se rechaza si falla una operación esperada y el error no se captura.
Por ejemplo, este es un patrón secuencial autocontenido:
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
async function processInOrder(items = [1, 2, 3], process = async item => item * 2) {
const results = [];
for (const item of items) {
results.push(await process(item));
}
return results;
}
processInOrder();
Este ejemplo ilustra el patrón y no incluye resultados de ejecución. Inicia una llamada a process cada vez. Es una opción sencilla para el trabajo que debe mantener un orden, aunque el tiempo total aumenta según lo que tarde cada operación.
Ejecutar trabajo asíncrono de forma concurrente con Promise.all
Cuando las operaciones son independientes, map puede crear una promesa por elemento y Promise.all puede esperar a que termine el grupo. Todas las callbacks de map se invocan mientras se recorre el array; entonces, las operaciones pueden solaparse. El array de resultados resueltos conserva el orden de entrada, no el orden de finalización.
El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés.
async function processTogether(items = [1, 2, 3], process = async item => item * 2) {
return Promise.all(items.map(item => process(item)));
}
processTogether();
Este patrón resulta útil para un número moderado de tareas independientes. No hace que forEach se pueda esperar: aquí map resulta útil porque devuelve el array de resultados de las callbacks, que Promise.all puede procesar. Promise.all se rechaza si se rechaza una promesa de entrada. No cancela el trabajo que ya haya comenzado, así que esas operaciones pueden continuar después de que se rechace la promesa agregada.
Gestionar errores y limitar la concurrencia
Gestiona los errores en el nivel que corresponda a la tarea. Usa try/catch alrededor de una operación esperada cuando el bucle pueda recuperarse o añadir contexto útil; de lo contrario, deja que se rechace la función asíncrona que contiene el bucle para que quien la llama gestione el error. Para un grupo concurrente, captura el rechazo de Promise.all alrededor del grupo. Un rechazo no revierte el trabajo ya completado ni detiene otras operaciones que hayan comenzado.
Iniciar todas las operaciones a la vez puede sobrecargar un servicio, un conjunto de conexiones o un recurso local cuando el array es grande. Promise.all no limita la concurrencia. Para una carga de trabajo grande, usa una cola o una utilidad que limite la concurrencia, o procesa lotes de tamaño fijo y espera a que termine cada lote antes de iniciar el siguiente. Elige un límite adecuado para el recurso utilizado; el tamaño del lote fija un máximo por lote, pero no garantiza la capacidad del servicio.
Cuándo conviene usar otros métodos de array
Elige un método de array según su propósito y el valor que devuelve. map devuelve un array nuevo con el resultado de cada callback; por eso, con una callback async, devuelve un array de promesas. Espera a que se resuelvan con Promise.all si deben ejecutarse como grupo. filter devuelve un array filtrado según los resultados síncronos de la callback. Un predicado async devuelve promesas, que son objetos truthy, así que filter no espera a que se resuelvan esos predicados ni utiliza sus valores booleanos posteriores.
Del mismo modo, some comprueba los resultados síncronos de la callback y devuelve un booleano de inmediato; una callback asíncrona no hace que espere una respuesta posterior. reduce devuelve el acumulador producido por su callback, y para secuenciar pasos asíncronos un reductor asíncrono requiere encadenar promesas de forma deliberada o usar un bucle con await. Para cada método, comprueba si devuelve los valores que necesita quien llama al código. Cuando sea necesario esperar al trabajo, usa un bucle explícito o recopila las promesas y espera a que se resuelvan.