Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Registros de resultados de Promise.allSettled()

`Promise.allSettled()` devuelve una promesa que se cumple con un array de resultados en el orden de entrada cuando todas las promesas terminan. `status` indica si hay que leer `value` o `reason`.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

Promise.allSettled(iterable)

// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }

Promise.allSettled(iterable) es un método estático de Promise que recibe un iterable síncrono, como un array. Trata cada elemento como lo haría Promise.resolve(): adopta el resultado de los objetos thenable y usa los valores simples como valores de cumplimiento. Cuando todas las promesas de entrada se han cumplido o rechazado, la promesa devuelta se cumple con un array con un resultado por elemento, en el orden de iteración y no en el de finalización.

Cada registro es un objeto JavaScript ordinario. Con status: "fulfilled", tiene una propiedad propia value, pero no una propiedad propia reason. Con status: "rejected", tiene una propiedad propia reason, pero no una propiedad propia value. Comprueba primero status: 0 y undefined pueden ser valores de cumplimiento válidos, y el motivo de rechazo no tiene por qué ser un Error y también puede ser undefined.

A diferencia de Promise.all(), un rechazo individual se registra en el array y no rechaza por sí solo la promesa conjunta. Esto permite conservar los resultados correctos de tareas independientes y gestionar los fallos por separado. Un error al leer el iterable sí puede rechazar la promesa conjunta en lugar de producir un registro de resultado.

Para una entrada vacía, el método devuelve una promesa ya cumplida con [], pero la función pasada a .then() se ejecuta de forma asíncrona. Si la entrada no está vacía, con el comportamiento estándar de las promesas, la promesa conjunta sigue pendiente cuando el método la devuelve, aunque ya no quede ninguna promesa de entrada pendiente. Sin embargo, puede devolverse ya cumplida si el único elemento es una promesa nativa que Promise.resolve() devuelve sin cambios y cuyo método propio then llama de forma síncrona a la función de cumplimiento.

Ejemplos

{
  let finishFirst;
  const first = new Promise((resolve) => { finishFirst = resolve; });
  const second = Promise.reject("offline");
  const batch = Promise.allSettled([first, second, 0]);
  finishFirst("profile");

  batch.then((results) => {
    console.log(JSON.stringify(results));
    for (const result of results) {
      if (result.status === "fulfilled") {
        console.log(`value: ${result.value}`);
      } else {
        console.log(`reason: ${result.reason}`);
      }
    }
  });
}

Resultado

[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0

La segunda promesa se rechaza antes de que se cumpla la primera, pero su registro sigue en la segunda posición. El valor simple `0` produce un registro con estado `"fulfilled"`.

Lecciones relacionadas

  • JavaScript · Lección 15 · Intermedio · Versión: 3

Fuentes