CKTIS / JavaScript
Promise.all — un resultado común de varias promesas
Promise.all devuelve una sola promesa para todos los elementos de un objeto iterable. Si la iteración termina sin errores y todos los elementos producen un valor, la promesa se cumple con un array de resultados en el orden de entrada. El primer rechazo observado entre las promesas de entrada hace que se rechace la promesa conjunta. Una excepción lanzada durante la iteración también puede provocar su rechazo, aunque no se rechace ninguna promesa de entrada. El método no cancela las demás operaciones.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
Promise.all(iterable)Promise.all(iterable) es un método estático que acepta un objeto iterable síncrono, como un array. Devuelve una nueva promesa que se cumple con un array de valores cuando todos los elementos terminan correctamente. Se aceptan valores normales; los objetos con un método then invocable se asimilan como promesas.
El orden de los resultados sigue el orden de entrada, no el orden en que terminan las operaciones. Una entrada vacía produce una promesa ya cumplida con []; las funciones de retorno pasadas a .then() siguen ejecutándose de forma asíncrona. Con una entrada no vacía de valores normales o promesas cumplidas, el cumplimiento del resultado también es asíncrono.
El primer rechazo observado rechaza la promesa combinada con el mismo motivo, sin esperar a que las demás tengan éxito. Esto no cancela su trabajo. Gestiona los rechazos con .catch() o con try/catch alrededor de await. El método no invoca las funciones proporcionadas: para recoger sus resultados, invócalas y pasa las promesas que devuelven.
En el ejemplo, first se cumple después de second, pero el resultado conserva el orden de entrada. El número 3 aparece sin cambios en el array, y sync se muestra antes que el resultado.
Ejemplos
const first = Promise.resolve().then(() => "A");
const second = Promise.resolve("B");
Promise.all([first, second, 3]).then((values) => {
console.log(JSON.stringify(values));
});
console.log("sync");Resultado
sync ["A","B",3]
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.