CKTIS / JavaScript
Promise.allSettled — resultados de todas las promesas
Promise.allSettled acepta un objeto iterable y devuelve una promesa con un array de los resultados de todos sus elementos. Conserva el orden de entrada y registra tanto los valores de las promesas cumplidas como los motivos de rechazo.
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.allSettled(iterable)Promise.allSettled(iterable) es un método estático disponible desde ECMAScript 2020, no una API web independiente. Acepta un objeto iterable síncrono, como un array, y procesa sus elementos según Promise.resolve. Por tanto, los valores normales también son entradas válidas. La compatibilidad con el navegador de destino debe comprobarse por separado; la versión de Node usada en un repositorio no la demuestra.
La promesa devuelta se cumple con un array cuando todos los elementos se han asentado, ya sea por cumplimiento o por rechazo. Los resultados siguen el orden de entrada, no el orden en que se completan. Cada resultado tiene la forma { status: "fulfilled", value: ... } o { status: "rejected", reason: ... }. Comprueba status antes de leer value o reason.
A diferencia de Promise.all, el rechazo de un elemento no rechaza la promesa agregada. Esto no significa que el método nunca pueda rechazarla: una entrada no válida, como null, o una excepción durante la iteración puede provocar el rechazo. Si la iteración termina sin errores pero algún elemento nunca se asienta, la promesa agregada queda pendiente.
Con una entrada vacía, la promesa devuelta ya está cumplida con [], pero una función pasada a .then sigue ejecutándose de forma asíncrona. El método no cancela operaciones ni limita la concurrencia; recopila sus resultados.
Ejemplos
const inputs = [Promise.resolve(10), Promise.reject("offline"), 30];
Promise.allSettled(inputs).then((results) => {
console.log(JSON.stringify(results));
});Resultado
[{"status":"fulfilled","value":10},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":30}]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.