Promise.any()

iterable

Ein iterierbares Objekt (wie ein Array) von Promises.

Ein Promise, das:

• Bereits abgelehnt ist, wenn das übergebene iterable leer ist.
• Asynchron erfüllt wird, wenn eine der Promises im gegebenen iterable erfüllt wird. Der Erfüllungswert ist der Erfüllungswert der ersten Promise, die erfüllt wurde.
• Asynchron abgelehnt wird, wenn alle Promises im gegebenen iterable abgelehnt werden. Der Ablehnungsgrund ist ein AggregateError, das ein Array von Ablehnungsgründen in seiner errors-Eigenschaft enthält. Die Fehler sind in der Reihenfolge der übergebenen Promises, ungeachtet der Abschlussreihenfolge. Wenn das übergebene iterable nicht leer ist, aber keine ausstehenden Promises enthält, wird das zurückgegebene Promise trotzdem asynchron (statt synchron) abgelehnt.

Die Methode Promise.any() ist eine der Promise-Konkurrenzmethoden. Diese Methode ist nützlich, um die erste erfüllte Promise zurückzugeben. Sie bricht ab, nachdem eine Promise erfüllt ist, sodass sie nicht auf die Fertigstellung der anderen Promises wartet, sobald eine erfüllt wurde.

Im Gegensatz zu Promise.all(), das ein Array von Erfüllungswerten zurückgibt, erhalten wir nur einen Erfüllungswert (vorausgesetzt, mindestens eine Promise wird erfüllt). Dies kann vorteilhaft sein, wenn wir nur eine erfüllte Promise benötigen, aber es uns egal ist, welche es ist. Beachten Sie einen weiteren Unterschied: Diese Methode lehnt beim Erhalt eines leeren iterierbaren Objekts ab, da das iterierbare Objekt wahrheitsgemäß keine zu erfüllenden Elemente enthält. Sie können Promise.any() und Promise.all() mit Array.prototype.some() und Array.prototype.every() vergleichen.

Auch im Gegensatz zu Promise.race(), das den ersten erledigten Wert (entweder Erfüllung oder Ablehnung) zurückgibt, gibt diese Methode den ersten erfüllten Wert zurück. Diese Methode ignoriert alle abgelehnten Promises, bis die erste Promise erfüllt wird.

Promise.any() erfüllt sich mit der ersten erfüllten Promise, auch wenn eine Promise zuerst abgelehnt wird. Dies steht im Gegensatz zu Promise.race(), das mit der ersten erledigten Promise erfüllt oder abgelehnt wird.

const pErr = new Promise((resolve, reject) => {
  reject("Always fails");
});

const pSlow = new Promise((resolve, reject) => {
  setTimeout(resolve, 500, "Done eventually");
});

const pFast = new Promise((resolve, reject) => {
  setTimeout(resolve, 100, "Done quick");
});

Promise.any([pErr, pSlow, pFast]).then((value) => {
  console.log(value);
  // pFast fulfills first
});
// Logs:
// Done quick

Promise.any() wird mit einem AggregateError abgelehnt, wenn keine Promise erfüllt wird.

const failure = new Promise((resolve, reject) => {
  reject("Always fails");
});

Promise.any([failure]).catch((err) => {
  console.log(err);
});
// AggregateError: No Promise in Promise.any was resolved

In diesem Beispiel haben wir eine Funktion, die ein Bild abruft und ein Blob zurückgibt. Wir verwenden Promise.any(), um ein paar Bilder abzurufen und das erste verfügbare anzuzeigen (d.h. dessen Promise aufgelöst wurde).

async function fetchAndDecode(url, description) {
  const res = await fetch(url);
  if (!res.ok) {
    throw new Error(`HTTP error! status: ${res.status}`);
  }
  const data = await res.blob();
  return [data, description];
}

const coffee = fetchAndDecode("coffee.jpg", "Coffee");
const tea = fetchAndDecode("tea.jpg", "Tea");

Promise.any([coffee, tea])
  .then(([blob, description]) => {
    const objectURL = URL.createObjectURL(blob);
    const image = document.createElement("img");
    image.src = objectURL;
    image.alt = description;
    document.body.appendChild(image);
  })
  .catch((e) => {
    console.error(e);
  });

• Polyfill von Promise.any in core-js
• es-shims Polyfill von Promise.any
• Promise
• Promise.all()
• Promise.allSettled()
• Promise.race()